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A new generation of Color Computer products 



VfTMAt Tenfilfial Emulator am or 5t2k w» m o.dy) m imfrovedi 

9^nmm tm #wi M Am «HMrt ndviuiced t^irMlml pw4^g:rmmm i^w tlie CoC<> tit «Y«rttt 

liEliTIWiCb Vf-lii^ Vr-Sf^ ViaiM^iH^^iet niM firaphic$ dl$|»liiy)^ aiMl standiMrd CRT eitiuliitloit$. Full um of $t2K, 
SiXIt iMt iMT «n«life« 4iumteUgnf WUihIow« a Multl-ta$kltifi(Dl$k 0ii$fc|), BAMDISK lUce buffer^ Xmodem* Kmod^m- 
CRC, YMffMn w , JCMi/Xoif» Motmchrome monitor ^iipport^ Capture buffer, $nap$hott Cottfereuce mode^ Serinl/HS- 
f»/PCifjfcii f>fc^ W/«/ao Tmcto, Over 5$ pagen of doc»l Vl$k ...... W9.9S Ver 02.00.00 upgrade .,..,. <6.95 




KLnJnL'^A" (CoCo ni only) The dazzling Word Processor and document creator for the CoCo HI! 
MAX-IO Is the perfect partner for CoCo MAX III! Mix graphics and text to get great looking newsletters, 
tenn papers, ect». MAX-IO .... 179.95 CoCo Max III .... $74.95 or buy BOTH for $139.95 and save! 



JM^flXSOUND imk i>t si2k Coco m only) See Jutie '88 teview 

tmm soar CoCo HI Into a HBAt digital audio sampler with HIGH quality audio reproduction. Easily add es^otlc effects, 
. CCHO» $ttttterlng, $peed $hlfting» $equeiictaig, und reverse audio to BASIC or Mt programt or GRAFHlCSt Now 
fc M| M <i N Data Compre$$lou. Imagme recording any Voice, Mu$lo, or Sound effect and being able to use these DIGITAL 
tea»rditigs iu your own programsl 9 disk $ide9 Includes; INnTEHFACT/BlN - ML driver for itound effects. GIbM/BAS - 
Adds sound effects to Graphics. SHOWTIME and DEMO disks* SCOPE/BAS - Turus CRT into a Digital Os<:illosoope 
to fook at MAXSOUND waveforms. CALL TO HEAR 'OVER THE PHONE' DEMO .^.... $59.95 



MAXSOUND SOUNDTRACKS W/GRAPHICS (MAXSOUND program NOT req'd) Call for Titles .... $5.95 



GRAPHICS-25 (n»c<^»..«, g». .hi. maxsound «»,> cbc m« mi 

UtllUu^ the PULL H2k memorsr range of your CoCo 111 from BASIC lor graphlcsl Create up to 2S ONBOARD HIRES 
SCREENS! Six uew BASIC commands ^low fnstaut display swHchlug while secretly drawing other screens. Save nn4 
load screeus to and from disk. Copy oue $cftm to «uother^ Fast Graphics act|ou» Smooth animation^ aud tOO% 
Machine Uuguage code- Requires DECtt 1.0^ OECg UU or FKEYS III* Complete with documeutatiou. Disk .. 124,95 



MULTl-LiABEL Dl (CoCo m only) see July '87 review. An easy to u$e» versatile label creating program 
including many new CoCo m features. Print multiple fonts on each labell Disk $16.95 



FKEYS DDL (CoCo l/n/IO) See April '87 review. A user friendly^ user programmable function key utility that 
creates up to 20 (unctlott keys, frndudes mi EDITOR^ DOS mods^ DISABLE^ mid it's EPROMablel« Disk , 119.95 

SDCDSIVB (CoCo I/li/m) This machine language utility modlites t>ECB 1.0, 1.1, FKEYS ID. or ADOS to 
allow the use of 3 double-sided drives (or 2 D/S drives and JTAB'tt RAJIDISKS) as 6 S/S drives. Disk ., $16.95 



A.U10 LiJLnA (CoCo in only) See Jan. '88 review. This hardware device protects your monitor, or TV from 
IMAGE BURN after a few minutes of Inactivity from your keyboard. Illustrated and easy to install. Hdwe $29.95 

MPI-0)CO Locking Plate (CoCo in only) Now 2 styles Protects your CoCo IH and Multl Pak 
Interface from destroying each other! Please specify MPI number 26-3024 or 26-3124 when ordering! Only $9.95 



in Quest of the Stat Lofd (CoCo m only) Enjoy the mixture of saence and fmitasy 
as yoa quest for the Phoenix Crossbow, the only thing that eati sAve you tn the post<*hotoeaiist urortd* 4 0isfc 
sides of animated graphics adventurel Outstanding 320x200 graphtest Disk ,^..,, $34,95 Hint Sheet .^,.^, $3.95 



Kung-FU Dude (CoCo I/n/ni) see Feb. '88 review. A Kung-Fu program for the CoCo. Destroy opponents 
and evade obstacles as you grow even closer to your ultimate objective! Disk $24.95 

PYRAMIX (CoCo ni only) See Dec. '87 review. Brilliant colors, sharp graphics, and hot action! Disk .. $19.95 






AD&D Character's Companion (cocoi/n/m) Great times^ving 



^utility helps create compiitiMe AD^bD characters, litcfudes dice roOltig routine, plc^ ability, race ^ cliiss. Buy 
from the Players Handbook, mugic Items & spell materials. Save, load, and print character Info. 3 Disk sides $24.95 



White Fire of Eternity (CoCo l/n/ni) see Dec '86 review. A great graphics adventure! Disk.. $19.95 
^-"AMPION (CoCo I/n/III) see May '87 review. Become a superhero In this action adventurel Dlsk..$19.95 
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Technical assistance: 7pm to 9pm GIMMESOFT Add $3.00 for shipping and handling 

Orders: 9am to 9pm Eastern time P.O. Box 421 Add $2.50 for COD (USA only) 

On-line orders and up to date Perry HaD. MD 21128 MD residents add 5% sales tax 
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First things first - a Happy Thanksgiving 
to all of our readers everywhere and a very 
Merry Christmas and Happy Chanuka as well. 

Second, my apologies for being as late as 
we are with this edition* A number of 
advertisers, unable to get space in another 
CoCo magazine, asked us to make room for 
them. Knowing our readers are always looking 
for a good buy we said "sure," In addition we 
were also informed that "InterTan" (Tandy of 
Canada) will no longer be ordering CoCo 3's. 
We have received many letters from CoCo 
owners in Canada mentioning this to us. I 
spoke with Fran McGehee of Tandy and she said 
that this was solely an InterTan decision and 
that it in no way affected the CoCo in the 
U.S.A. She said that Tandy was fully behind 
the CoCo here in the States. Canadian CoCo 
owners who want to contact InterTan will find 
them in Barrie, Ont . The area code is 705. We 
urge you to write to let them know your 
feelings. Remember that you can catch more 
flies with honey than vinegar. 

Other than that bit of bad news a LOT has 
been happening with CoCo Clipboard Magazine, 
We were the guests of the CoCo section of the 
Philadelphia Area Computers Society in 
September. Our thanks to Paul Sgrillo and his 
family for opening their home to us* Also our 
thanks to Bob Hengstebeck for making the 
arrangements and too the folks who attended 
the meeting at LaSalle College* Our thanks as 
well to Paul and Kathy Bornemann in Trenton, 
NJ for their hospitality on Saturday evening. 
Paul has written a couple of articles for us 
and is a very active business user of his 
CoCo* s. 




i Dar draws a name for a free 
v subscription, 

October found us visiting many of you at 
the Hyatt Regency in Princeton, N.J* In 
particular our thanks to Tom and Jason of 
CoCo Tech for all of their help* Be sure to 



check their ad in this issue. Also joining us 
was Jim DeStafeno and Ed Gresick of Delaware. 
Jim produces ClipDisk and Ed, who is using 
the CoCo to operate his Radio Shack franchise 
store, answered questions about programming 
and about the CoCo in general. Our thanks to 
all of you who stopped by and said hi. 

You may have noticed the number of our ads 
has increased. We can't thank our advertisers 
enough for their support. We can't urge you 
enough to support these hard working men and 
women as they support all of us with their 
hard work. And use those Clipboard coupons. 

We've been asked several times if we 
would open a "Classified Ads" section in the 
magazine. We have resisted this for some time 
for a number of reasons. However more and 
more people have asked for this service and 
so we will open up a "Classified" section. We 
will be monitoring this experimental section 
very closely. The last thing we will tolerate 
is stolen merchandise and that includes 
pirated software. We reserve the right to 
refuse any ad and we will not take ads for 
x-rated, porno, or lottery/ganbl ing software. 
Details are as follows: 

A) - All ads must be pre-paid in full. Check, 
money order or credit card. Credit card 
orders will be billed at 10% surcharge. 

B) - Ads are 50 cents a word with a 10 word 
minimum. Subscribers of record may take ads 
at 40 cents a word with a 10 word minimum. 

C) - Ads must be typewritten. They must be 
contain the name and full address of the 
advertiser and we must have your phone number 
for confirmation of your order. 

D) - CoCo Clipboard Magazine will not be 
liable in any way for items advertised in the 
Classified section. There are ng refunds on 
these ads . c - 

E) - Classifieds are open only to private 
individuals or groups. Commercial ads will 
not be accepted. 

This will be a limited Z edition 
experiment. If we don*t have any major 
problems we will continue the service. 

Hope this finds you all well and having 
fun, producing and learning. Have a Happy New 
Year and we'll see you all in 1989. 
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TERRY SIMONS' 
Computer Villa 

PRESENTS 

"Home-Pac 3.2" 
F>A>S>T C>H>E>C>K/CARD & MAILER 

+ 
DISK JACKET 



>B0C 



128K, Disk 



RGB or Composit Monitor Req, 



Rush Caley of Emerson Computer Services says:"/ hav0 
SBen countless chBckbook programs -for the CoCo, Some i^ere 
commericial ly aval lahle^ others v^ere nritten by users -For 
their own use. In a hford, I have NEVER seen a program -For 
this purpose as good as Terry's Home-Pac,** 



1 . 
2. 
3. 
4. 
5. 
6. 
7. 



Full 80 Column - large amount of data displayed 
Credit-Card & Checks - Constant balance -• two accounts 
V3.2 has "prompt cards" making it easier then ever 

Plus - date parms - printer dump 
Disk Jacket Program - 70K-^ CoCo Power 
useful part of your house! 
"Satisfaction Guaranteed"! 
Clipboard Review. S3^ 



Full sortability 
Mai ler Program & 
Make your CoCo a 
Home-Pac is 
See August 



^ny order $2,50 Shipping 
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$EREE Christmas Disk t^ith any order I 
F=*cDe 1 ^11 32K CC2 or 3, disk Req. 

Do you have over a year of Coco 
Magazines? If you have one year or several years of CoCo magazines, 
"Indexer" will find article you want FAST! Telling you the name and 
month of the issue. Total of six years, including 1988. Covering over 
5 CoCo Mags, including "Clipboard", and Rainbow of course. Over 200K of 
compressed data! (Two Disksfull). Plus it's a great a great magazine 
article indexer for; "any type file you'd like to create"! $21.95 
Three first class Programming Tools! 
Z. Disk Programmin g Pa lii- 4 routines a. ADDML appends ML routines to 
basis b. UNPACKER Undoes basic packed programs c. MLBASIC Converts a 
basic program to ML format to be LOADMed & EXECed. Encryps & BREAK 
protects, preventing others from viewing or altering your code d. JOIN 
Joins several ML routines, and/or adds auto-exec, if desired. $14,95 

5. PACKER: Removed REMed statements redesignating line No's. Removes 
spaces tokenizing basic to a more ^compact form. Joins lines up to 2K 
long! Five packing functions in all. terror checking $14.95 

4, MAPPER! Cross-references all Variables & Strings + GOTO's & 
GOSUB's, by line No. & occurence times. Screen/Printer display. $14.95 
Van d&ir Poel LJt: 1 1 1 ±: i es 

5..- Disk Management System! Auto-Program filing system also keeps 

copies of (and restores) disk directories. $14.95 

6. Disk Utility Pack II! Superfast - Format Backup 3 or less swaps 
per 64K system. Utilizes from 32K to your maximum 64/128/512K! Plus 
Find; Compare; Diskmatch; Occount; MENU 16 programs in all! $14.95 

7. BVDP Stock Manager $19.95 8. BVDP 'TqCo Three" Cribaoe 1/5.95 



Computer Villa, Chini s-tmas Gnai=>hi c • s & Oano 

Graphics by Terry (g) Simons, are presently used by several 
Top Software Go's. The Christmas disk Specify CoCo 2 or 3. $4.95 
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The Machine Shoppe 



Andrew Bartels 




Have you tried to get started programming 
in Assembly, but not gotten very far? If 
you're used to BASIC programming. Assembly 
does have a complex look to it, and chances 
are there are MANY other CoCoists out there 
wondering about answers to the same Assembly 
questions you are! That's why CoCo Clipboard 
is printing my column, The Machine Shoppe - 
to answer your questions. So if you've got a 
problem dealing with Assembly, no matter how 
small or how big, drop me a line. I'll see if 
I can help you out in The Machine Shoppe. 
Mail your Assembly questions and troubles to: 

Clipboard Machine Shoppe 
c/o Andrew Bartels 
1859 East 8th Street 
Mesa, AZ 85203-6649 
Phone: (602) 827-1934 

If it's an emergency, and you just have to 
talk to me right away, I've included my 
"Assembly Questions Hotline" phone number 
here as well. Remember, no question is too 
big or too small. I look forward to hearing 
from some of you soon! Meanwhile, here is 
this two month's worth of questions and 
answers: 

Q: What are the "Condition Codes"? I know 
they have something to do with the CC reg- 
ister , but since I'm Just starting Assembly, 
I'm not sure what they do. 

Troy Gresickf 
Springfield, Illinois 



A: The Condition Codes are a series of eight 
bits in the CC register. Those eight bits are 
called "Condition Codes" because they change 
often, and reflect the results of the last 
operation performed by the computer. A map of 
the bits in CC, along with what thev do is in 
Table 1. 

How do they work? Well, suppose you have 
written Assembly code to do a subtraction of 
two numbers, The result of that subtraction 
is recorded in CC. If the answer to the sub- 
traction was zero, the "Z" bit of CC would be 
set (equal to one). The "N" bit of CC is set 
only if the result is negative. In the above 
example, "N" would be clear (equal to zero). 

The "V" bit is set when an overflow 
occurs, such as when you add 70 and 200 
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Table 1: Bit Map of the Condition Code Register ( CC 
Bit Name Description 



Carry Code, for carry and borrow 
actions of adding and subtracting 
Overflow Code, set when you over- 
flow a register (like adding too 
much ) . 

Zero Code, set when two values are 
equal or a subtract equals zero. 
Negative Code, set if one value is 
less than another, or if subtract 
results in negative number. 
IQR Interrupt flag, clear when 
CoCo is on an IRQ interrupt call. 
Half Carry, to carry out of bit 3. 
FIRQ Interrupt, clear when CoCo is 
on a Fast Interrupt Request. 
Entire State on Stack, to tell 
what a Return From Interrupt (RTI) 
does . 



together, and try to keep the answer in only 
eight binary bits. The "C" bit is likewise 
set when there is a need to carry or borrow 
in addition or subtraction. Other bits in CC 
deal with coordinating the system interrupts 
so the machine does not lock up. 

The relative branch instructions are prime 
examples of how you can make branches in your 
programs according to the conditions re- 
sulting from various tests. The BEQ in- 
struction stands for "Branch if Equal". The 
branch actually occurs when the "Z" (zero) 
condition code is set. The computer performs 
a subtraction when it compares things, and a 
subtraction of two equal values will result 
in zero. So, you branch when two numbers are 
equal, the BEQ relies on the "Z" condition 
being set. The other conditional branches 
work in this manner, except with different CC 
register bits. 

chapter 6 of TRS-80 Color 
Language Programming, by 
for more on how these 
the Condition Codes. You 
be a very important part 



Take a look at 
Computer Assembly 
Bill Barden Jr. , 
branches work with 
will find them to 
of Assembly. 



Q: I've been having trouble doing 8-bit 
signed multiplies. Fortunately, the 6809 in- 
struction set has a MUL instruction that does 
8-bit multiplies. But this is UNSIGNED. Is 
there a way to get signed values from it? 

Arlin Parsons, 
Naples, Florida 



A: I*m sure you mvist then be familiar with 
the convention for signed numbers in binary, 
where the highest order bit determines the 
sign (one is negative, zero positive) instead 
of carrying a value. To get a signed multiply 
out of an unsigned one, Just regard the high 
order bit as a sign^ and not as part of the 
number. 

First, the binary operation called Ex- 
clusive OR is what we can use to determine 
the resulting sign when the numbers are 
multiplied. Table 2 shows the truth table for 
Exclusive OR, in both binary, and in plus and 
minus signes (as it applies to mathematics). 
The listing of SMULT.ASM below shows how to 
do the signed multiply you asked about. Lines 
110 to 140 get the resulting sign bit into 
bit 7 of a byte and push that byte on stack. 

Table 2: Exclusive OR Truth Tables 



B I nary 
f 1 



Number Signs 
! + 



1 

1 



Lines 150 through 170 actually multiply 
the numbers to get the unsigned result. Now 
it*s just a matter of clearing out any high 
order bit from the answer (taking it*s ab- 
solute value I and then applying the sign bit 
we had saved earlier* Line 180 performs the 
absolute value, and line 190 logical OR*s the 
sign byte on stack with the most signif- 
icant byte of the answer. Since the sign in 
the sign byte is bit 7, and all other bits 
will be clear, we can easily put the correct 
sign on the answer with line 190. 

Line 200 cleans up the stack, line 210 
saves the answer to memory, and from there 
line 220 returns. It's that simple. You can 
always do this on signed numbers, regardless 
their size (assuming the size does not exceed 
the number of bits you are working with J. 
This will even work on signed divides too* I 
hope this fixes the problem. 



Q: I am a proud CoCo 2 owner ^ and up until 
now, I've had a cassette only system, I got 
into Assembly with the EDTASH-f- program pak, I 
Just got a new disk system, and was thinking 
it*d be interesting to see how to do disk 
I/O, Some Assembly applications Just need 
that available. 



Dave Hill is, 
Seattlet Washington 



A: You may have heard that disk I/O is much 
harder than cassette I/O. That's true, 
especially if your Assembly program commun- 
icates directly with the upper memory I/O 
bytes devoted to disk access. But that is 



much too involved to discuss in a Q&A column 
such as this. Fortunately, TANDY provided us 
with a much easier way for this which is 
explainable quickly. It deals with a ROM 
routine called DSKCON. The address where 
DSKCON can be found is always, and will 
always be contained in ROM addresses SC004- 
$C005. The pointer to the parameter bytes for 
DSKCON operation is at *C006-$C007. All you 
do is LDX $C006, and X will point to the 
correct place to store the necessary five 
parameters. 

Assuming you've done a LDX $0006, the 
following parameters are as shown in Table 3» 
relative to X. The first parameter la what 
operation you wish to perform. By putting a 
zero at the location referenced by ", X** you 
tell it to restore the drive read/write head 
to track zero. A code 1 there means no op- 
eration, 2 tells it to read a sector* and 3 
instructs it to write a sector. 

Now» the next step is to select the drive 
number. If you just bought a new disk system, 
you probably only have one drive to access, 
which would be drive number zero. But CoCo 
can support up to four drives (numbered 0-3)* 
The drive number goes here at the address 
referenced by n,X" (called DCDRV ) . 

From here on, the parameters only need to 
be selected if you chose operation code 2 or 
3 for DCOPC (read and write, respectively). 
This next value is referenced by "2,X", and 
is called DCTRK . It selects the disk track 



= — = RROOSK SOFTWARE = — = 



c/c Mike Snyder, Rt. 2, Box Bf, Allen OK, T4B2S 

Adventures are supplied on Disk Only, but are 
transferable to tape. All are text only. CoCo 1, 2 
and 3 cofnpatable. 



::-^ C lipboard SPECIAL j^r- 

th any order of 3 or more, you may choose a 
program with the coupon on the coupon page! 



free 



Here's our Hne-up 

SHADOW WORLD Travel to the future! 

TREASU RE SEARCH Find King Erik's Treasurel 

ASTEROID BT Escape from an Asteroid? 

DESTINATIOW: UNK NOWN You are stranded! 

ROB OCRQOK Catch the mechanical menace! 

COUN TRY CL UB Get There In Two Hours! 

SILE NCE SYN DRONE Find the Secrets of the Cloud! 

ANOTH ER DIMENSION Escape to Another Time! 

Plus more being created Bvery Day! 

P tease note: More than one game may be sent on the| 
same disk on orders of two or more. 

Just ^12. BO for each game ordered 
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RAINBOW 



If You Are Serious About Stocks. 
This Prognm Is A Must! 



Stock Market portfolio for the color computer 
will keep track of all your current stock listings 
and keep a listing of stocks you have sold by the 
year^they were sold with all totals, profit and 
loss, and percentages. More than one person 
can use this program as long as the first three 
letters on both first and last name are not the 
same. The program is menu driven and will 
give you the option for either screen print or 
information to be printed on printer. 
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Rush Check for $22.00 phis $3.00 shipping k handling to: 
Paparis Enterprises 
700 York St 

Waiiamsburg, VA 23185 
Please allow 2-3 weeks for delivery 
Sorry no CO.D.S 
VA rcsidenis add 4.5% sales lax. 



number involved. The disk is divided into 35 
tracks, so select anything from zero to 34 
here. 

Table 3: DSKCON Routine Parameters 



Name 


Relative 
If You LDX 


to X, 
$0006 


Description 


DCOPC 




,x 






Operation Code: 

= Restore to 

track zero. 

1 = No operation 

2 = Read 

3 = Write 


DCDRV 




i,x 






Drive number, from 
to 3. 


DCTRK 




2,X 






Track number, from 
to 34 


DCSEC 




3,X 






Sector Number, from 
1 to 18 


DCBPT 




4,X 






Address of 256 byte 
I/O buffer. 



Next is DCSEC, referenced by '•3,X", lets 
you select the sector number. Each disk 
sector contains 256 data bytes, and there are 
18 of them on each track. So, choose a value 
from 1 to 18 to store here. 



( 1 1 . i > . O . ) 

<1> HDD can help you choose and execute 

your various appi ication programs 

<2> You manke Menuzs and Scripts - HDO will 

do the work 

<3> It' your system has the capacity, you can 

reach 2 miLLLOD programs in Just 8 

keystrokes 

<4> Indiv iduals with no know ledge of 0S9 

are able to use your programs 

<5> IIDO has been success I'u I ly run on both 

the CoCo & 68 K OS 9 Systems 

<6> HDO s u ppo rts multiple terminal 

coti figurations 



Sample Menu: 

Hard Disk Organizer System 

1. Developmeiil of Files 

2. Busi. & Word Piocessiiig 

3. Cofliiauiii cat ions F^rograms 

4. Exit 






The H.l),(). program is avai table from: 
Bob llengstebfck, 108 Grand\ lew Ave., 
Feasteri'ille, PA 19017, (215) 3:^2-5155 

H.IKO. is just $2 1,95 f $3,00 shipping and 
packaging. 



And lastly, we have DCBPT, referenced by 
"4,X". Here is how you tell Disk BASIC where 
your I/O buffer is located in memory. If you 
are writing, this is the address of the 256 
data bytes that go out. If you are reading, 
this becomes the address at which Disk BASIC 
stores the 256 data bytes it reads from the 
disk. 

Once you. finally get done setting the 
parameters needed to specify what operation, 
what drive, where at on the disk, and where 
at in memory, you are ready to call DSKCON. 
To call it, just JSR [ $C004 J . That jumps to 
the subroutine whose address is contained 
within $C004~$C005, where DSKCON's address is 
stored in ROM. 

After you have called DSKCON, either what 
you told it to do is done, or things were 
aborted due to an error. So, you need to test 
out the error status report referenced by 
"6,X". It is called DCSTA. If that byte is 
zero, no errors have occured. If some bit or 
bits in here are set, you've had some kind of 
error. Table 4 lists out the definitions of 
each bit of DCSTA. When an error happens, 
you'll have to provide the necessary routines 
to report the error. 

Okay, now we know how to get one sector 
loaded in or written out. What about some- 
thing more complex, like doing a DIRectory? 
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Well, we just use a series of DSKCON calls to 
read the directory, and from what we read in, 
we can then display a list of what's on the 
disk. The DDIR.ASM listing provides an ex- 
ample of how a double column direcory can be 
printed to the screen, and how the repeated 
DSKCON calls are used to get the directory 
information. 

This has been a fairly brief overview of 
disk I/O. Another version of explaining 
Assembly disk I/O is written in chapter 11 of 
your disk system owner's manual. That too 
will help you on your way to building the 
necessary I/O routines you'll need. The 
DDIR.ASM Assembler listing is a complete 
directory routine, and it will help you see 
how to use DSKCON to do the disk I/O while 
the rest of your program controls the 
process . 



Table 4: DCSTA bit definitions 



DCSTA is referenced at 6,X, where you * ve done a 
LDX $0006. Bit error definitions are as follows: 



Bit Description 



2 Lost data 

3 CRC of data isn't right 

4 Desired record not found 

5 Write fault 

6 Disk it write-protected 

7 Drive not ready for use. 



* The information for Tables 3 and 4 is taken from 
the disk system owners manual, Chapter 11: 
Techincal Information. 



Listing of SMULT.ASM: 



00100 




ORG 


$E00 


00110 


SMULT 


LDA 


VALUEl 


00120 




EORA 


VALUE2 


00130 




ANDA 


#$80 


00140 




PSHS 


A 


00150 




LDA 


VALUEl 


0016Q 




LDB 


VALUE2 


00170 




MUL 




00180 




ANDA 


#$7F 


00190 




ORA 


,s 


00200 




LEAS 


i,s 


00210 




STD 


RESULT 


00220 




RTS 




00230 


VALUEl 


FCB 





00240 


VALUE2 


FCB 





00250 


RESULT 


FDB 





00260 




END 


SMULT 



GET ONE VALUE 

FIGURE RESULTING SIGN IN BIT 7 

KEEP ONLY BIT 7 

SAVE SIGN BYTE FOR LATER! 

GET ONE VALUE 

GET OTHER VALUE 

DO UNSIGNED MULTIPLY 

GET ABSOLUTE VALUE (CHOP OFF HIGH BIT) 

PUT PRE-FIGURED SIGN ON IT 

CORRECT STACK 

SAVE RESULT 

AND RETURN 

FIRST 8-BIT SIGNED NUMBER 

SECOND 8-BIT SIGNED NUMBER 

SIGNED ANSWER (16-BIT) 
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The Assembly Line 



Kraig Brockschmidt 





Welcome once again to the Assembly Line. 
As of October, 1988, feel free to address 
questions to me on CompuServe through my ID, 
76701,76. 

ML~DATA Turbo Tranform: 

At one time I needed to put 2028 bytes of 
machine language into Basic DATA statements 
so the ML could be poked in memory by a Basic 
program. Well I wasn't very ambitious to type 
2028 numbers so I made a 111 byte ML program 
that did it for me. I call it ML-DATA Turbo 
Transform. 

The binary program for ML-DATA Turbo 
Transform can be stored in memory using the 
Basic program in Listing 1 (ML-DATAB. BAS ) or 
by assembling the source code in Listing lA. 
Once the program is in memory, (C)SAVEM 
"ML-DATA", &H7F91,&H7FFF,&H7F91. Listing 2 
ML-DATAO.BAS) is an operating program for ML- 
DATA which facilitates use of this utility. 
Cassette users--change the LOADM in line 1 to 
CLOADM" "and CSAVE the operating program 
before the ML program on a cassette. The op- 
erating program is described later. 

As in previous articles, a line of BASIC 
code stored in RAM has a rigid structure. 
Transferring machine language to BASIC DATA 
statements requires us to build this struc- 
ture. For a disk system, BASIC programs start 
at address $2600 if 4 graphics pages are 
reserved ( PCLEAR 4). A BASIC program in 
memory appears as follows: 

$2600 :Always 

$2601-02 :A 2 byte address pointing to 

the data for the next BASIC 

line . 
$2603-04 :A 2 byte value for the line 

number. 
$2605- :Data for the BASIC line with 

all commands tokenized 
(see Vol 1 #2 of CoCo Clipboard). 

At some point there is a indicating the 
end of the BASIC line. The next byte in mem- 
ory is the start of the next line. The ad- 
dress of this next byte is the address stored 
at $2601-02. From this point on, the 
structure repeats for each line of BASIC 
code, until three zeros occur, signaling the 
end of the program. 

Through the following steps, ML-DATA 
builds BASIC lines. The numbers in par- 



enthasis indicate the lines of the assembly 
code where the step is done: 

1 ) Determine where to begin forming 
Basic lines. (110-130) 

2) Get the starting line number and the 
start address for the ML to be trans- 
ferred. (140-160) 

3) Write the line number in the current 
Basic line. (170) 

4) Write a "DATA" and a space the 
current line. (180-190) 

5) Check for the end of the ML being 
transferred" "and exit a loop if it 
has been reached. (210-220) 

6) Otherwise get a byte of ML, convert 
it a two-byte ASCII string (with hex. 
digits), store it in the DATA state- 
ment, and add a comma. (200-480) 

7) If the DATA statement is longer than 
desired, start a new line. To start a 
new line, clear the last byte, store 
next address at the beginning of the 
previous line, and increment the 
line number. (410-520). 

8) Continue loop by returning to step 3 
until step 5 exits loop. (530) 

9) Upon exit, a termination routine pre- 
vents the end of the last line from 
having just a comma or just a line 
number with "DATA". 

It also stores the new end address of the 
Basic program at $1B and returns to Basic. 
(540-660) 

When the > operating program is used, the 
machine language program automatically 
loaded. You are asked to enter the start 
and end addresses of the ML to be transferred 
and the line number you wish the DATA state- 
ments to begin at. These values are stored in 
$14C, $14E, and $150 respectively. Note that 
the start address should always be less than 
the end address and the starting line number 
greater than 6. If the start > end you will 
get no DATA statements. If your line number 
is > 65535 you'll get an ?FC ERROR IN 5. 
Also, if you specify a large beginning line 
number, the line numbers may wrap-around to 
low numbers at the end of the BASIC program. 
Continuity problems can be fixed with a 
RENUM . 

As always, there are several points of 
interest in the ML program. The main routine 
(200-480) loads a byte of ML data to tranfer 
into the A register and copies it to B. If 
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you are familiar with hexadecimal digits 
stored in a byte, you will know that the 
upper 4 bits (the MSN, Most Significant Nib- 
ble) contain the first digit, and that the 
lower 4 bits (LSN, Least Sig. Nibble) contain 
the second digit. We must isolate and in- 
dividually convert these digits to ASCII. 

Lines 240-290 isolate the first digit in 
the A register by perforining a logical AND 
with a bit pattern of 11110000. The last 4 
zeros mask out the second digit. Similarily 
the second digit is isolated in the B reg- 
ister through a logical AND with 00001111. 
The bits of the A register are then shifted 
four bits to the right, so it contains the 
actual value of the digit. For example, the 
conversion of the value $C8 into two digits 
proceeds as follows: 



Line 



A register 



B register 



230 TFR A,B 
240 ANDA #$F0 



11011000=$C8 
11010000=$C0 



250 ANDB #$0F 11010000=$C0 

260 LSRA 01101000=$68 

270 LSRA 00110100=$34 

280 LSRA 00011010=$1A 

290 LSRA 00001101=$0C 



11011000=$C8 
11011000=$C8 
00001000=$08 



00001000=$08 



The A register now contains the value of 
the first digit, $C, and the B register con- 
tains the second, $8. Lines 300-390 then 
converts both registers to ASCII. In line 
300, A is compared to 9. If it is greater 
than 9, then it must be a hexadecimal letter 
(A-F) so we branch to LTR. If not, we add 48 
decimal to the value giving it a possible 
range of 48-57 decimal. These are the cor- 
responding ASCII codes for "0"-"9*'. If we 
branch to LTR we add 55 decimal instead. 
Since it was originally 10-15, the possible 
values for A after the addition are now 
65-70, which translates to "A"-"F" in ASCII. 

This process is perfomed on both A and B 
registers (lines 300-390) and then the 
two-byte ASCII value in the D register (A and 
B together) is written to the current BASIC 
line under construction (400). Lines 410-450 
check the length of the line under con- 
struction, we first save the value of X in D 
and then subtract 77 from X. This number 
(77) corresponds to the length of a BASIC 
DATA statement with 25 elements. We then com- 
pare the subtracted value to the beginning of 
the line stored at S. If X-77 is less than 
the value at S, a comma is stored after the 
data element and we continue building. If 
not, there are 25 pieces of data in the 
current line so we branch 
another* line. Note that 
struction in line 440 
register. 

Lines 490-520 finish up 
and starts the next. It clears the last byte 
of the line, stores the next location at the 
beginning, of the line (see structure), 
stores this value at S, and adds 5 to the 
line number counter (in U). Line 530 jumps 
back to line 200 where we continue building 
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to EOL, starting 
the TFR D,X in- 
does not effect the CC 

the current line 



Basic lines. When we reach the end of the ML 
to be transferred the program exits the loop 
to FINUP (540-660). This routine simply fixes 
the end of the Basic line so there are no 
commas or line numbers ending the line. It 
also stores the end address of the new Basic 
program at $1B and returns to Basic. 

By the way, if you're wondering why this 
utility is dubbed 'Turbo Transform' , try 
this: enter START=&H8000 and END=&H9FFF in 
the operating program. LISTing the result 
will take a while, but prepare to wait a 
whole 0.93 seconds for ML-DATA Turbo Trans- 
form to construct it!! 

11 ** ML TO BASIC UTILITY * 

12 ** COPYRIGHT (C)1988 ^ 

13 '* BY KRAIG BROCKSCHMIDT * 

14 '* 14506 NE 37th Pi. F-8 * 

15 '*Believue, WA 98007-3486* 

15 '***********************^* 

^0 CLS:CLEAR200,&H7F91 :F0RT=1T01 
11 :READA$:X=X+VAL( "&H^' + A$ ) :NEXT: 
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is not another v/ord prcx^essor. rFXIFORf^l is a user 
defineable two column text formatter program wtiich 
will allow your Color Canputer to create very 
professional documents without hours of tedious 
work. TEXTFORM is a versitile enhancement to any 
word processing system whether you are a casual or 
professional user. 

Id«'.'\l For: 

- BulJftins - SchooJ newspapers 

- Advertisfmciit?; - Club newslelters 

- Proi?ram I.istingn - BusinoRP reports 

- And mnrh more. . 
System Requirements: 
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IF XOIIOIOTHEN PRINT'^ERROR IN D 

ATA. ";END 

30 RESTORE ; FORT= ITOl 1 1 : READA$ : PC 

KE&H7F90+T,VAL( ''&:H"+AS ) :NEXT:PR1 

NT"ML DATA IN MEMORY-": END 

40 DATA9E,1B,30,1E,34,10,F£,01,4 

C,10,BE,01,4E,30,02,EF,81,CC,86, 

20, ED, 81 ,A6,A0,10 

50 DATABC , 01, 50, 22, 39, IF, 89, 84, F 

0,C4, OF, 44, 44, 44, 44, 8 1,09, 2 2, 03, 

8B,30,8C,8B,37,C1 

60 DATA09 , 2 2 , 03 , CB , 30 , 8C , CB , 3 7 , E 

D,81, 1F,10,30,88,B3,AC,E4,1F,01 , 

22,06,86,2C,A7,80 

70 DATA20,C9,6F,80,AF,F4,AF,E4,3 

3 , 45 , 20 , B6 , 6F , 1 F , 30 , ID , AC , E4 , 2 7 , 

02, 30, 03, 06, 06, 6F 

80 DATA 85,5A,2A,FB,AF,F1,30,02, 

9F,1B,39 



2 CLS:INPUT"STARTING POINT (IN H 
EX)*' :A$:A = VAL{ "&H'*+A$ ) 

3 INPUT^'ENDING POINT (IN HEX)";B 
$:B=VAL( ^'&H''+BS ) + l 

4 0=INT( A/256 ) : W=INT( B/256 ) :X=&H 
1 4E : POKEX , Q : POKEX+1 , A-256*Q : POKE 
X+2,W:POKEX+3,B-2 56*W 

5 INPUT" STARTING LINE NUMBER'' ;S: 
E=INT(S/256) :P0KE&H14C,E:P0KE&H1 
4D,S-256*E 

6 EXEC&H7F91:END 

7 'NOTE!! WHEN YOU HAVE PUT ALL 
THE ML INTO DATA STATEMENTS, DEL 
ETE LINES 0-8 OF THIS PROGRAM AN 
D WRITE A PROGRAM TO POKE THE 

8 \ML INTO MEMORY WHERE YOU WANT 
LIKE IS SHOWN IN LISTING IB. 



*ML TO BASIC UTILITY * 
* COPYRIGHT (C)1988 '^ 
^BY KRAIG BROCKSCHMIDT* 
*14506 NE 37TH PL N.E.* 
*RENTON, WA 98056-7313* 
*********************** 
1 PCLEARl :CLEAR200,&H7F91 :LOADM" 
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Using 0S9 




Bob van der Poel 




As I've been telling you all for some time 
now, OS-9 is a super operating system for the 
Color Computer. But something we all tend to 
forget from time to time is that OS-9 is a 
DISK operating system. Not only does this 
mean that OS-9 can load and save programs or 
data to/from disks, it also means that the 
system itself thrives on all kinds of disk 
operations. But before we get to this month's 
article which shows one way we can make 
BASIC09 do some mundane work for us, let*s 
review OS-9's file structure. 

OS-9, unlike some other operating systems 
you may be aware of, has only one type of 
file. There is no inherent difference between 
the structure of a file containing a list of 
names and addresses or the file containing 
the program which reads it. OS-9 cannot tell 
whether a file contains data or executable 
code -- that is job of file attributes. Note 
that attributes are not a part of the file, 
they are part of the file descriptor. 

The file descriptor is a one sector block 
of data which contains -- among other things 
— the attributes of the file, the date the 
file was created and last modified, and 
information on where the file is located on 
the disk. Whenever OS-9 accesses a file this 
information is read. Depending on who you are 
and what you are trying to do OS-9 may or may 
not process your request. On a multi-user 
system you may not be the owner of a file, 
and unless the "public read" attribute is set 
OS-9 will not let you read the file. Sim- 
ilarly, if the "write" attributes are not set 
write or delete the file. If a 
executable program then it will 
"execute" attributes set. Again, 
separate "execute" flags for the 
file and other users on the system 
t,he file attributes can be 
OS-9 ATTR utility, however 
the attributes of a file 



no one can 
file is an 
have the 
there are 
owner of a 
(public). Most of 
changed with the 
you cannot change 



you do not own. 

File attributes cause lots of problems for 
beginners -- especially if they have down- 
loaded a program, attempted to create a new 
Shell module by merging several programs 
together, or extracted a program with an ar- 
chiving utility (like AR ) . OS-9 will balk at 
any attempt to load a program which does not 
have its "execute" attribute(s) set. It*s 
simple to do -- just use ATTR to set the "E" 
and "PE" attributes. Does this mean that if 
we change the attributes of a data file to 
"E" and "PE" it will be loaded into memory? 
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No. OS-9 does other checks to make sure the 
"program" is correct ... but that's grist for 
another article. 

Most of the time when we think about files 
we focus on two kinds: Data files and exe- 
cutable programs. But let's not forget that 
files can be used for more than just data 
storage. Files can also contain instructions 
for programs or OS-9. Procedure files are an 
example which comes to mind right away. 

A "procedure file" is a file which contains 
commands which you would normally type in 
from the keyboard ... but because we're lazy 
(or just against drudgery) we can put these 
instructions in a file. The file "startup" on 
your boot disk is a good example of a pro- 
cedure file. Startup contains instructions 
which OS-9 fulfills each time it is booted. 
The only unique thing about "startup" is its 
name -- OS-9 always checks the root directory 
of the disk it is booting from for a file 
called "startup." If it finds one, the in- 
structions in the file are carried out. If 
"startup" does not exist, no damage is done. 
One caution about invoking programs from 
within procedure files: When interpreting a 
procedure file OS-9 expects input to come 
from the file, not the keyboard. If a program 
needs input from you (the keyboard) then you 
must redirect input when the program is in- 
voked . 

Here's a quick example. You wish to auto- 
mate the process of creating a new system 
disk, so you write the following procedure 
file: 

echo Creating new boot disk, ready /dl 

format /dl 

cobbler /dl 

makdir /dl/CMDS 

chd /dl/cmds 

copy /dO/cmds/grfdrv grfdrv 

copy /dO/cmds/shell shell 

The above procedure will not work. Format 
will print an "are you sure" message and wait 
for you to answer y(es) or n(o). Since input 
is coming from the file the first reply will 
be "c" (the first letter in "cobbler"). For- 
mat will re-prompt and get "o" as a response. 
Eventually it will get to the the "y" in 
"copy" and the disk will be formatted. How- 
ever OS-9 will not like the name "/dO/cmds 
/grfdrv," nor will it be able to execute the 
command "grfdrv. " 



The solution? Well actually there are two. 
We could change the format command so that no 
keyboard input is required: 

format /dl r "MyDisk" 

will work fine. However, if we wish to have a 
prompt — nice, just in case the disk in /dl 
contains valuable data -- then we could use: 

format /dl </l 

Note that instead of "</l" we could have used 
"</term," but that would only work if we were 
using "term" as our active window. If would 
create all kinds of problems if we were using 
"/w2." 

If you create a special "startup" file to 
automatically invoke a favorite program, then 
redirection is also needed, I have a special 
disk which brings up my mailing list program. 
The final line in the startup file reads: 

dml9 <>>>/! 

Here not only input, but also output and 
error output has been redirected. The last 
two should not be necessary, but leaving them 
out sometimes causes problems. Play it safe 
and redirect all three paths. 

There is one more use of files: com- 
municating with other programs. Probably the 
best example of this is the C-Compiler ex- 
ecutive. Creating a C program is a rather 
complex process of creating/editing a text 
(source) file, having various programs con- 
vert the source file to an assembly language 
source file (compiling), calling RMA to 
assemble the complied code, and then calling 
the OS-9 linker to create the final program. 
Rather that forcing you to remember all this 
the C~compiler comes with a program which 
creates a procedure file with all the nec- 
essary instructions to convert your source 
file to a loadable program. 

I write a fair number of letters. I use an 
editor to create the text of the letter, save 
the text to a disk file, then I use one of 
the many text formatters available for OS-9 
to format the text and print it out. Simple, 
but a bit tedious. First off, there's that 
matter of my "letterhead" information. I keep 
a file called "header" which is included in 
each letter. It contains my name, address, 
etc. and some formatting information. How- 
ever, it must still be loaded (or included) 
for each letter I write. But a greater ir- 
ritant is the fact the the formatter will 
only print one copy of the letter. If I want 
two copies I have to call the formatter 
twice. And if I want the second copy to be in 
correspondence quality rather than draft then 
I have to remember to set the printer. Too 
many things for me to remember. But aren't 
computers supposed to be good at doing 
tedious things? 

The program listing "Ip" takes the tedium 
out of printing letters. It's a simple pro- 



gram which I hope you will change and expand 
for your own needs. 



Lp creates 
following : 



file which contains the 



1. Some initial format information for my 
text formatter, 

2. The letterhead information with my name, 
etc. , 

3. A line to print out todays date, 

4. An "include" instruction to print the 
actual letter, 

5. A closing to the letter, 

6. A "start new page" command, 

7 . A format code to turn on correspondence 
mode , 

8. A duplication of items 1 to 6 . 

After the file is created the program calls 
the formatter and two copies of my letter are 
printed. Finally, the temporary file is 
deleted -- all this simply by typing the 
command : 

lp ("Jim") 

Note the parentheses and quotes around the 
argument. These are needed for a packed BASIC 
09 program, unless you are using an enhanced 
shell program such as Shell+. 

There is nothing very complicated about lp, 
however I do wish to point out a few high- 
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lights. The routine which builds the string 
"today" assumes that the system date has been 
properly set. The month name is determined by 
reading through the data statements for the 
value of the month number from DATE$ . We ex- 
tract the month number with the MID$ func- 
tion. The IF/ELSE is needed to strip off a 
leading "0" from dates like "January 03." 

Before attempting to create the temporary 
file, we first attempt to delete that same 
file. In most cases this will not be nec- 
essary, however if we attempt to create a 
file which already exists we'd have to delete 
it anyway. Note that error trapping is only 
active for the DELETE. Any other errors will 
simply end Ip. 

The subroutine at line 100 reads the data 
statements at 1000 and sends them to the 
temporary file. Have a good look at the data 
statements — not only do they contain string 
constants, they also contain variables and 
expressions. BASIC09 is the only language I 
know of which permits expressions in data 
statements -- a very useful feature. 

As it stands, Ip is a very specific program 
something I don't like to publish. 
However, it should be easy enough to modify 
to include your letterhead and codes for your 
text formatter. Feel free to play with the 
code -- that's how you learn. 

Finally, this months challenge: Can you add 
or devise a "better" method for creating the 



temporary file name? Can you find another use 
for a program like Ip? Let me know, maybe 
you'll even get your name mentioned here! You 
can write to me at: 

17435-57 Avenue 
Edmonton, Alberta 
Canada T6M lEl 
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Clip'Ettes 



Jim DeStafeno 




- LINE LINEUP: 

This one is from Rush Caiey as a result of 
my complaint. He laughed when he found I 
didn't know. Was I the only one in the dark? 
As anyone knows that uses a CoCo word pro- 
cessor, the printer code uses a character 
sp^ce on the screen, but since the printer 
doesn't print them, the printed line is one 
character shorter then the screen line. 

A printed line with 4 or more printer 
codes looks bad enough; pretty short. How- 
ever, if you make a form with vertical lines, 
bold print, underlining, etc., lining up 
columns can be come a nightmare. 

Try this, it works perfectly. The base of 
the idea is founded on the fact that most 
every printer code is, or can be, preceded or 
followed by a space. So, just set a space in 
the printer code itself and don't use one in 
the text. Then when the printer encounters a 
printer code, it will not print the code, and 
thereby lose a character space in the printed 
line, but it will print a space. The result 
is a net gain/loss of zero line character 
spaces between the displayed line and the 
printed line, and therefore everything lines 
up on the screen and on the printed page. 

The drill goes this way. When you set up 
the printer code, put in a 32 either in front 
of or behind the code. (That is the ASCII 
value of a space.) Example, 32 nn nn nn or 
nn nn nn 32. (The ns represent the printer 
code.) When you type in a line, think of the 
printer code as a space; do NOT type in a 
space , 

- FUNCTION, CTRL and ALT KEYS SENSING FROM 
BASIC: 

The program below demonstrates how to 
sense the function keys from BASIC. It's not 
a bad input engine for fields or a word pro- 
cessor. (Note, if you do use it, be sure to 
filter out the Left Arrow and Clear keys; 
similar to what is done in line 20 for ENTER. 
You'll fine the program to be fast enough, 
but the Hi-Speed Poke wouldn't hurt. However, 
a fist full of IF statements will slow it 
down. It will work fine if a second INSTR 
statement is used to do the filtering.) 

Anyway, check out how this thing works. 
There is a keyboard table in memory locations 
338 through 345. If the memory location has a 
number in it other than 255, a key is being 
pressed. A given number in a given location 
tells the computer which key is being 
pressed. The location for <F1> is 343: <F2> 
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is 344, CTRL is 342 and ALT is 341. The 
For/Next lets us Peek into these locations 
and check out the values. 

5 CLS:C$=CHR${255):C=191:D$=CHR$(103)+CH 

R$(52)+CHR$(4)-fCHR$(214)+CHR$(189)+CHR$( 

1 ) +CHR$ ( 64 ) : PRINT@32 , C$ ; 

10 EXEC44539:I$=INKEY$:FOR X=341 TO 344: 

IF PEEK(X)=C THEN ON INSTR(D$,I$) G0T031 

,32,33,34,35,36,37 ELSE NEXT 

20 IF I$=CHR$(13) THEN A$=" " : CL3 :G0T05 E 

LSE A$=A$+I$:PRINT@32,A$C$:GOTO10 

31 PRINT@452,"<F1> KEY ACTION" : GOTO 10 

32 PRINT@452,"<SHIFT Fl> KEY ACTION" :GOT 
OlO 

33 PRINT(»452,"<F2> KEY ACTION" : GOTOIO 

34 PRINT@452,"<SHIFT F2> KEY ACTION" :GOT 
OlO 

35 PRINT@452,"<CTRL> KEY ACTION" : GOTOIO 

36 PRINT«452,"<SHIFT CTRL> KEY ACTION" :G 
OTOIO 

37 PRINT@452,"<ALT> KEY ACTION" : GOTOIO 

It is handy each of key's "is being 
pressed" code is 191. So if we Peek the four 
locations and find a 191, we know which key 
is being pressed. However, the shift key has 
no effect on the numbers in keyboard table. 
(Expect there is another memory location to 
sense that, but I don't know where it... 
Help?) 

So once the program has determined if one 
of the four keys has been pressed, INSTR is 
used to determine which one. Notice line 5 
sets D$ to the ASCII code, CHR$(n), of seven 
characters, our four keys; shifted and un- 
shifted. (The shifted ALT doesn't affect the 
key table . ) 

One question might come to mind, "Why not 
just use the ASCII code to sense which key is 
being pressed without using the For/Next?" 
ell, Fl has the same ASCII code as the 
owercase "g", one of the others is the same 
s "4" and CTRL-ALT is the same as "@" ; but 
one of them have the same same "key table 
ode" as their counterpart. 

Of course if you want to get fancy, there 
re lots of ways to modify the program to 
hange the quantity and/or order of the sen- 
ors to get different results. 

YOU and CLIPETTES: 

If you have some favorite programming 
ricks, send them in to the magazine or my- 
self; RDl Box 275, Wyoming, DE 19934. 



GOT THOSE 

XowpaiMibi BCuc*?" 

You're not alone. Many Color Computer users have experienced the frustration of buying a cheap imitation of 
our Hard Drive Basic and then discovering that their favorite programs no longer work! 

Now, you can FIX those compatibility problems, ELIMINATE the bugs, SPEED up your system and PREPARE for 
tomorrow's disk drives ... buy your DOS from the company that invented the original Hard Drive Basic years 
ago! 

Supercharge your Color Computer with RGB-DOS! 

Why RQB-DOS? Because RGB-DOS is the first and only Disk Operating System to bring STANDARD Small Computer 
Systems Interface (SCSI) device drivers to the Color Computer system, running under Basic. 

What does this mean to you? 

First, SCSI is an accepted, industry standard interface system. This allows you to run one or more Hard Disks 
of any size on your Color Computer in Basic or under OS-9. But wait! There's MORE! 

Because it provides generic SCSI drivers, RQB-DOS will ALSO run devices which you may not have TODAY, but 
will need to run TOMORROW, such as Streaming Tape Backups for the Hard Disk, CD ROMS and of course. 
Optical (Laser) Disk Drives! 

RQB-DOS, combined with the KEN-TON or DISTO SCSI Interface, will assure you that your Color Computer System 
will be compatible with the ever growing line of mass storage products available both TODAY AliD TOMORROW. 

Here are some of the many features of RQB-DOS: 

•Hundreds of systems in daily use - PROVEM QUALITY 
•Runs ALL popular COCO software - FULLY COMPATIBLE 
•Will AUTO-BOOT ATiY program from Hard Disk or Floppy Disk 
•Full Screen Directory Display for COCO 1, 2 and 3 
•Automatic Drive number. Free Space &i Disk Mame Display 
•Supports Double Sided Floppy Disk Drives 
•Reliable Floppy Disk Operation with the "High Speed Poke" 
•Improved "COPY" command - Copy Filename to Drive number 
•"RUIiM" Command for Machine Language Programs 
•FLEXIKEY - Command Recall & Edit System by Colin J. Stearman 
•Fixes the COPY bug, the DSKini bug, the DOS bug 6f many others 
•Will run two Hard Disk Drives of the same or different sizes 
•Will run Streaming Tape Backup systems df Laser Disks 
•Automatic Hard Disk Size detection. nO drivers to configure 
•Works with the LR-TECH, DISTO 6f KEM-TOIi Hard Disk Interfaces 
•no extra RAM used or extra tokens added. FULLY COMPATIBLE 
with The Color Computer 1, 2 OR 3 WITHOUT MODIFICATIOn 

•Easily Affordable. The RQB-DOS System Disk with Users Manual 
is only $29.95 plus $3.00 shipping 8c handling 

Don't ivatt! Supercharge your Color Computer TODAY . . . with RQB-DOSI 

COMPUTER 
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A Point & Click blindov System 
for the rest of us fff 

Fully CoBipatible with /?.5. Dos 

&ihanced Basic, it does not need 

or use 0S-3f and you don ' t have to 

be a Rocket Scientist or a P,H,D, 

to use UindoiffSi Pull Down Menus t 

Buttons f Iconsi Edit fields or 
Mouse Functions in your Programs f 



IT 
O 



B 8 

o 



liiLllMliJM 
leleie Key 
lisplay Keys 

Save Keys 
Load Keys 



ograi Keys Used 

OPEN:?CHR$F^ 



BUTTON 
OPEH 255;7 



B 2 



B 3 



IfliT (?= UTNiiny rinsF fifi:^ 



DRIVE 1 

BftS 8 B 2 
BAS 8 B 2 



ONMENUl 
CONFIG 

CHECK BAS 
AUTOEXEC BAS 8 B I 
CONFIG SYS 1 A 1 



: DRIVE 3 



Hi ndov Master 
Finder VLB 

Unit ten by Bill Very on 3 
Copyriyht <c> 1388 by Cer-Comp Ltd 



Window Master Features 

Multiple Windows 



Screen Display Fonts 



Window Master supports up to 54 different character sizes on 
the screen with 5 different character styles. You can have Bold, 
Italic, Underlined, Super-Script, Sub-script or Plain character 
styles or any combination of them in any character size. You 
can also change the text color and background at any time to get 
really colorful displays. 

Fully Basic Compatible 

Window Master is fully compatible with Enhanced Color 
Disk basic with over 50 Commands & functions added to fully 
support the Point & Qick Window System. Window Master 
does not take any memory away from Basic, so you still have all 
the Basic Program memory available. 

^ Hi'Resolution Displays 

Window Master uses the full potential of the Color 
Computer 3 display by using the 225 vertical resolution display 
modes instead of the 192 or 200 resolution modes like most 
other programs. It uses either the 320/16 color mode or the 
640/4 color display to give you the best display resolution 
possible, and can be switched to either mode at any time. 



Window Master supports multiple window displays with up to 
a maximum of 31 windows on the screen. Overlapping windows 
are supported, and any window can be made active or brought to 
the top of the screen. Windo^-s can be picked up and moved 
anywhere on the screen with the mouse. There are 6 different 
Window styles to choose from and the window text, border and 
background color is selectable. 

Pull Down Menus 

Menus are completely programmable with up to 16 menus 
available. They can be added or deleted at any time in a 
program. Menu items can be enabled, disabled, checked or 
cleared easily under program control. Menu selection is 
automatically handled by Window Master & all you have to do 
is read a function variable to find out which menu was selected. 

Buttons, Icons & Edit Fields 

Each Window can have up to 128 buttons, Icons or Edit fields 
active, if you can fit that many. Buttons, Icons and Edit field 
selection is handled automatically by Window Master when the 
mouse is clicked on one. All you have to do is read a Dialog 
function to find out which Button, Icon, or Edit field Vr-as 
selected, its very simple. 

Mouse & Keyboard Functions 



Window Master automatically handles the Mouse pointer 
movement, display and button clicks. It will tell you the current 
screen coordinate, the local window coordinate, window number 
the mouse is in, the number of times the button was pressed, 
which window number it was clicked in and more. The 
Keyboard is completely buffered, and supports up to 80 
programmable Function keys that can contain any kind of 
information or command sequences you can imagine. You can 
load and save function key sets at any time. So, you can have 
special sets of function keys for different tasks. The "Ctrl" key is 
supported so that you have a full control code keyboard 
available. 



OPTIONS 

CLEAR SCREEN 

DOTS 

BOX 

CIRCLE 

LINE 

QUIT 

LOAD 



IG, 1,00, 1,0,3,2,0 



iPHICe DCHO ^^^^= 
IONS", "CLEAR SCR 
-, -CIRCLE", -LINE 

iOAD", "SAVE" 



30 WINDOW OPEN 1 , 44 , 1 6 , 1 , 00 , 1 , 0> 

3,2,0, "WINDOW GRAPHICS DEMO" 

40 MW=1 : ' MY WINDOW #=1 

50 ON MENU GOSUB 540 

70 MENU ON 

80 PROTECT 3 

80 ON DIALOG GOSUB 630: D IALOG 



-t^ FOREGROUND 
-^ COLOR 



JhiSlSLcr 



N 

BREAK 

OK 

RUN 



ENTER FILE TO SAVE 



GFXTEST.PIC:2 



Mixed Text & Graphics 



Window Master fully supports both Text & Graphics displays 
and even has a Graphics Pen that can be used with HLINE, 
HCIRCLE, HSET and more. You can change the Pen width & 
depth and turn it on or off with simple commands. We also 
added Enhanced Graphics Attributes that allow graphics 
statements to use And, Or, Xor and Copy modes to display 
graphic information. With the Graphics enhancements added 
by Window Master, you could write a XOCOMAX" type 
program in Basic! In fact we provide a small graphics demo 
program written in Basic. 



Event Processing 



Window Master adds a powerful new programming feature to 
Basic that enables you to do "Real Time" Programming in Basic. 
It's called Event Trapping, and it allows a program to detect and 
respond to certain "events" as they occur. You can trap Dialog 
activity, Time passage. Menu Selections, Keyboard activity and 
Mouse Activit>' with simple On Gosub statements, and when the 
specified event occurs, program control is automatically routed 
to the event handling routine, just like a Basic Gosub. After 
sePricing the event, the sub-routine executes a Return statement 
and the program resumes execution at the statement where the 
event occured. 

Enhanced Editing Features 

Window Master adds an enhanced editor to Basic that allows 
you to see what you edit. It allows you to insert & delete by 
character or word, move left or right a word or character at a 
time, move to begin or end of line, toggle automatic insert 
on/off or just type over to replace characters. The editor can 
also recall the last line entered or edited with a single key stroke. 
You can even change the line number in line to copy it to a new 
location in the program. 



Window Master Applications 

Window Master pushs the Color Computer 3 far beyond its 
normal capabilities, into the worid of a "User Friendly" 
operating enviomment. We are already planning several new 
programs for use with Window Master. So you don't have to 
worry about having to write all your own programs. And don't 
forget that many existing Basic and M.L. programs will run 
under Window Master with little or no changes. The 
Possibilities for Application programs arc endless: Spread 
Sheets, Word Processing, Communications, Education, Games, 
Graphic Design, Desk Top Publishing and on and on. 

Hardware Requirements 

Window Master requires 512K of memory, at least 1 Disk 
Drive, a Hi-Res Joystick Interface and a Mouse or Joystick. 

Technical Assistance 

If you run into difficulty trying to use some of Window 
Master s features, we will be happy to assist you in any way 
possible. You can write to us at the address below or call us 
between 10am and 2pm Pacific Standard Time for a more timely 
response. Sorry, no collect calls will be accepted. 



Ordering Information 



To order WINDOW MASTER by mail, send check or money 

order for $69.95, plus $3.00 for shipping & handling to the 

address below. To order by VISA, MASTERCARD or COD 

callusat(702)-452-0632 

(Monday thru Saturday, Sam to 5pm PSHT) 

CER-COMP Ltd. 

5566 Ricochet Avenue 

Las Vegas, Nevada 89110 

(702)-452-0632 
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The Chicago Rainbow Fesi opens ioda^j^ 
and we will be there with Window Master! 




CoCo 'N Amateur Radio 



Mike Dooley KE4PC 




Editor * s Note: In our last iss 
part of the Basic program li 
supplied to us. To our fai 
Amateur Radio column readers 
apology. We are running the ent 
this issue. Mike's regular 
this listing. 

RTTY.BAS 

5 REM THIS PROGRAM IS PUBLIC DOM 

AIN, BY N6LQV 

10 CLEAR 200,&H4000:C=3 

20 D=(PEEK(&HC000)=68):REM TAPE: 

D=0, DISK: D=-l 
30 IF D THEN LOADM"RTTV' ELSE CL 
OADM"RTTY" 

40 DEFUSR0 = &HE00:DEFUSR1=:&HE03 
50 DEFUSR2=&HE06:DEFUSR3=&HE09 
60 DEFUSR4=&HE0C:DEFUSR5=&HE0F 
100 A=USRO(0):R=0:T=0 
110 CLS: AUDIO ON: MOTOR OFF 
120 PRINT" **'»^* RTTY TERMINAL PRO 
GRAM **♦♦•• 
130 PRINT" 

BYTES" 
140 PRINT" SAVE RECEIVE BUFFER 

" • R 
150 'print" PRINT ** *'" 
160 PRINT" SHOW * * * '" 

170 PRINT" RECEIVE/TRANSMIT" 
180 PRINT" LOAD TRANSMIT BUFFER 

";T 
190 PRINT" CLEAR ALL BUFFERS" 
200 PRINT" BAUD RATE: "; 
210 ON B+1 GOTO 220,230,240,250 
220 PRINT"45 WPM: 60": GOTO 260 
230 PRINT"50 WPM: 67":GOTO 260 
240 PRINT"57 WPM: 75":GOTO 260 
250 PRINT"74 WPM: 100":GOTO 260 
260 PRINT 
270 PRINT"DURING RECEIVE/TRANSMI 

m , II 

280 PRINT" BREAK: RETURN TO THIS 

MENU" 
290 PRINT" CLEAR: TOGGLE RECEIVE 
/TRANSMIT" 
300 PRINT" RIGHT ARROW: TRANSMIT 

BUFFER" ; 
310 A=C*32:PRINT@A+32, " ";:PR1N 
T@A+64,"->" ; :PRINT@A+96," " ; 
350 FOR 1=0 TO 30:NEXT 
360 A$=INKEY$ 

370 IF OO AND (PEEK(341) AND 8) 
=0 THEN C=C-1:G0T0 310 
380 IF C<6 AND (PEEK(342) AND 8) 
=0 THEN C=C+1:G0T0 310 
390 IF A$<>CHR$(13) THEN 360 
400 ON C+1 GOTO 800,500,550,600, 
700,100,950 

500 IF (PEEK(&HFF22)AND1 ) THEN 1 
10 

24 



ue we left out 
sting Mike had 
thful CoCo 'N 
we offer our 
ire listing in 
column follows 



:GOTO 1 



510 A=USR5(-2) : PRINT" 

10 

550 CLS:A=USR5(0) 

560 IF INKEY$="" THEN 560 ELSE 1 

10 

600 CLS:PRINT"RTTY RECEIVE M 

ARK--X--SPACE" :R=USR1 (B) : GOTO 1 

10 

700 S$="LOAD FILE":GOSUB 900 

710 IF A$="" AND D THEN 110 

720 CLS:PRINT@229, "LOADING ";A$ 

730 IF D THEN F=:l ELSE F = -l 

740 OPEN"T",F,A$:A=USR2(0) 

750 IF EOF(F) THEN 790 

760 LINEINPUT #F,A$ 

770 A$=A$+CHR$( 13) :A=USR3(A$ ) 

780 IF A THEN 750 

790 CLOSE F:T=USR4(0) :R=0:GOTO 1 

10 

800 IF R=0 THEN 110 

810 S$="SAVE FILE":GOSUB 900: IF 

A$="" THEN 110 

830 CLS:PRINT@229, "SAVING ";A$ 

840 IF D THEN F=l ELSE F=-1:G0T0 

870 
850 PRINT@293,"ARE YOU SURE (Y/N 
)"; : INPUT S$ ^ 
860 IF S$<>"Y" THEN 110 
870 PRINT@293, "" :OPEN"0" ,F,A$ 
380 A=USR5(F) :CLOSE F:GOTO 110 
900 CLS :PRINTS$: PRINT 
910 LINEINPUT"FILENAME?";A$ 
920 RETURN 

950 B=B+1:IF B>3 THEN B=0 
960 PRINT®269,"" ; :GOTO 210 

MAKERTTY.BAS 

10 REM THIS PROGRAM IS PUBLIC DO 

MAIN, BY N6LQV 

20 PCLEAR4 

30 CLS 

40 PRINT" RADIO TELETYPE TRANS 

CEIVER" 

50 PRINTSTRING$(32,"-" ) ; 

60 PRINT 

70 PRINT"NOW GENERATING MACHINE 

LANGUAGE" 

80 PRINT 

90 PRINT"PLEASE WAIT..." 

100 ST=&HE00:AD=ST:L1=900 

110 READA$,CS 



120 IF A$=:"X" THEN 200 

130 FOR 1=1 TO 64 STEP 2 

140 A=VAL( "&H"+MID$(A$,I,2) ) 

150 POKE AD,A:CS=CS-A:AD=AD+1 

160 NEXT 

170 IF CS THEN PR I NT "DATA ERROR 

IN LINE";LI:END 

180 PRINT(S174,949-LI 

190 LI=LI+1 :GOTO 110 

200 IF PEEK(&HC000)=68 AND PEEK( 

&HC001)=75 THEN B$="DJSK" ELSE B 

$="TAPE" 

210 PRINT@96, "PROGRAM IS NOW IN 

MEMORY AND" 

220 PRINT"READY TO BE SAVED. INS 

ERT ";B$ 

230 LINEINPUT"AND PRESS ENTER "; 

A$ 

240 IF B$="DISK" THEN 280 

250 CSAVEM"RTTY" ,ST,AD-1 ,CS 

260 LXNEINPUT"PRESS ENTER TO SAV 

E AGAIN " ;A$ 

270 GOTO 250 

280 SAVEM"RTTY.BIN" ,ST,AD-1 , CS 

290 END 

900 DATAl 60032 160 11 51 60068 16006C 
16003 2BDB3EDD76FBE4 013BC4 01 5 2418 
A680AD9F,2607 

901 DATAA002966F26F1AD9FA0002 7EB 
AD9FA0002 7FA20E3 3 98D2D8E7FFF9F17 
8E40299F,3863 

902 DATA048D219E04BF1202BF12C8yF 
06 9F08308904009C17 2 302 9E17 9F13 9F 
15000483,2591 

903 DATA4 029204E34 04C64 02003 34 04 
5F1F9B35848E402 9BF4 004 3 98DEAEG84 
EE029E04,2792 

904 DATA308904009C1 7242F108E0fc:BB 
A6C0340484 7FC6FE810D2 70C80202 50E 
813F2502,2570 

90 5 DATA80 20E6A61F985D1703C6 3 504 

5A26DDCCFFFF8DB6 7EB4F4 4F5F20F7FF 

20313429,3944 

906 DATA803A2B2F3 280802C2 33C3D36 

3 7 33212A3035 2 7 26382E3E8080803 980 

43594E49,2235 

90 7 DATA414D5A544 64B4F52 5C4C585 6 

5 74 A4 5504 75E5 3 5D5 55 18080802 5800 F 

6215D805,2685 

908 DATA2102900DFC13DB04A902550C 
44116B0417020B097 30D6A03260193BD 
B3ED8608,2365 

909 DATA3D8E0EFB3AEC84FD1131EC02 
FD1158EC04FD104 3FD1064EC06FD1092 
7FFF4017,3880 

910 DATAFF228E03004F6F804A26FB0F 
02CCFEF8DD000F0A0F0B8E13 7 39F0E9F 
260F220F,2820 



911 DATA230F1D8E0420CC6060ED818C 
060025F98E05E09F0C86BFA7848E05A0 
9F24869F,3412 

912 DATAA7841A501 7008 7D62 32604 8D 
1620F51CAF17FED6AD9FA00026FAFC40 
15B34013,3367 

913 DATA16FF0F9E26A6862B3A1F8981 
602502C0408D50816026028D4 4 9E24A7 
808C05C0,3098 

914 DATA251A8E04 20EC8820ED818C05 
A025F6CC6060ED818C05C025F98E05A0 
9F24869F,3779 

915 DATAA784 394C260CC60D8D198660 
A7 9F4024 20D04C2G058E139320064C26 
058E1373,2615 

916 DATA9F263 99E159C1724 04E7809F 
15 39962 2270 31700F4 962 3 2 701390F1E 
0F1F0F1B,2156 

917 DATAC6138D78DC1A81 522607 21 FE 
5A2A0A20DD5C2B02 2003CC00 7FD71B4F 
D61AD31E,2966 

918 DATADD1E8300002406AC01AC0120 
D3DD1E86059720CC0013971B971C8D40 
4FD61AD3,2901 

919 DATA1EDD1E830000240FDC1A8152 
C900D71B0C1C12C61220E3DD1ED61B58 
D11C0621 ,2752 

920 DATA0A2026CFAC94C6088D124FD6 
1AD31EDD1E83000025EE962 14 444 44 39 
8D4C4FD3,3140 

921 DATA1EDD1ECC00028D42CB028D3A 
CB028D3 6D71AC05 9502B02 2003CC0000 
C10F2202,2628 

922 DATA2003CC000FD1 1D26063D3DAC 
8B20138E0410A68584BFA785 961DD71D 
E686CA40,3157 

923 DATAE78617012639AC01AC018601 
5CC1 602504 A1012005B5FF2027F25CC1 
602504A1 ,2918 

924 DATA012005B5FF2026F2 3 98E0405 
CE14 2BA6C0A7808C04 0D2 5F7CC34 3CF7 
FF21B7FF,3646 

925 DATA018602B7FF200F1E0F1F9E06 
9C04 2 7 24CC0000DD1186059720E6809F 
06D7215F,2727 

926 DATA8D54AC94CC00085A26FD0421 
8D480A20 26F2EC9B3DAC8BCC0000DD11 
53803796,3344 

92 7 DATA2226C7CC34 3CB7FF21F7FF01 

8E0405CE14 23A6C0A7808C040D25F7 3 9 

B6FF208A,3731 

928 DATA02B7FF20862A971039B6FF20 

84FDB7FF20862 7 97103924 04 8DE22004 

8DEB2000,3444 

929 DATA801D4A26FDB6FF2088FCB7FF 
20D6104FD31EDD1E931124088D0F9610 
802320E2,360l 

930 DATADD1E3 9AC94 3DAC0 139960226 
7CDC00C03 74 98A0124 022003CCFEF8DD 
008E0300,3057 

931 DATA3AB7FF02B6FF008A801F89E8 
84E484 21FEA784 8607DD029E049C0626 
C69C0826,3805 

932 DATAC48E00009F069F089F043996 
02263ADC00C03 74 98A0124022003CCFE 
F8DD008E,2959 

933 DATA03003AB7FF02B6FF008A801F 
89E884E484 26BEA784 96014C2 7088B3 7 
970121FE,3530 

934 DATA20818607DD0216FF7A4A9702 
D601CB08D7010403247D86 7FB7FF02B6 
FF008440,3295 

935 DATA27058E13B320058E13EB2000 
A685E6852B289E04 980AD70A84 602609 
C41FE780,3004 



936 DATA3D21FE2012C6402604861B20 
04861 F2000C41FED81A1019F04 399E04 
5C260E96,2526 

937 DATA0A8440970ACC0004E7803D20 
EA5C260BCC0802A780ED81A18B20DC5C 
26490622,3280 

938 OATA270D8E40299F068E00009F04 
9F08393OAC8B39D60B2 74 7C004O70B8E 
05E03AEC,2844 

939 DATA84EO88E0CC6060EO81EC84ED 
88E0CC6060ED84D60B2 704 3OAC84398E 
05E09F0C,4453 

940 DATA86BFA78421FE395C26060322 
AC84 3D395C26070F2 2032 3AC84 393OAC 
01399E08,2605 

941 DATA9C04 2607CC000C5A26FO39A6 
809F089E0EA6862B12 9E0CA7808C0600 
24139F0C,2690 

942 DATA86BFA784AC8B3 94C260F1286 
60A79F400C8620970B3O3084 394C2609 
8E13939F,2987 



94 3 DATA0EA101200B4C26078E13 739F 
0E20013D3O12398045FF4 16053495580 
44524A4E,2303 

944 OATA46434B545A4C57485950514F 

4 24 7FE4D5856FO807 3FF6O605E78 7780 
64746760,3436 

945 OATA617A68756269726376707179 
7F66FE6E6F7BFO804 3 5 94E49414O5A54 
464B4F52,3457 

94 6 DATA5C4C58565 74A4 5 504 75E535D 

5 551258080FDFF363 733212A30352726 
382E3E2C,2581 

94 7 OATA233C3OFEFCFB808080808080 

4 3594E4 9414D5A64464B4F525C4C5856 
574A4550,3262 

948 DATA475E535D5551258080FDFF80 
2D313429803A2B2F32808080808039FE 
FCFB8080,3659 

949 OATA808080524543454956456054 

5 2414E534D4954000000000000000000 
00000000,1621 

950 DATAX,&HEOO 



Hmmmmm. . . . CoCo * s and Amateur Radio. 
What else can we do with this combination? 
How about antennas? Every Amateur needs a 
good antenna to operate a radio. Radios just 
don't work very well without them! 

A good, simple, antenna is the dipole. 
Figure 1 shows what the dipole will look 
like. There are insulators at each end of the 
dipole and an insulator in the center where 
we'll attach the feedline. 



fl 



Figure One 
(the dipole) 
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A dipole is one half wavelength long which 
is the distance from point A to C. A 
wavelength depends on the frequency we're 
trying to operate at. Since different fre- 
quencies have different wavelengths we'll 
need to do two things in order to build our 
dipole. First, what frequency will we be op- 
erating at? And second, how long is a half 
wavelength at that frequency? 

For the first item, let's build our an- 
tenna so it operates at 28.5 MHz. In order to 
discover the second item we'll need to start 
by learning what a wavelength is. 



Figure Two 

( two waves on 



line ) 




25 



Every frequency tias a corresponding wave 
length. Frequencies are measured in Hertz, or 
cycles per second. A wavelength is the length 
of wire it takes for one wave, or cycle, of a 
given frequency. Figure 2 shows two cycles, 
or waves, of a frequency. The first cycle is 
from point A to point C. The second is from 
point C to point E. 

Since we're building a half wavelength 
antenna, we only need to know how long half a 
wavelength is. There's a formula that allows 
us to calculate a half wavelength if we know 
the frequency. 

Length (ft) = 492/f requency (MHz) 

The MHz in parenthesis stands for Mega 
Hertz. We already know that Hertz is cycles 
per second. Mega means million. A frequency 
of 144 MHz is a short way of saying 144,000, 
000 cycles per second. 

The formula can be entered directly to 
calculate the length of wire needed for a 
half wavelength antenna, but it's wore fun to 
use a short program (Figure Three). 

10 CLS:W=0:F=0 

20 INPUT '* FREQUENCY ( MHZ ) ^* ; F 

30 REM PRINT ^'A HALF WAVELENGTH 

ANTENNAE WILL'' : PRINT^BE "; 492/F; 

'' FEET LONG*^ 

34 W=492/F:FT=INT{W) :IN=( W~FT)*1 

2 



litfiler: Keep the coipoke froi sviBglng ifom the gallon is 
this ipord guessing gaM. PIDDE3 graphics designed to be at- 
tractife on both lonochroie and color screens and good sound 
lake this m enjoyable challenge. Includes editor prograi to 
create your own word lists. IS. 00 

Blip: Test your Mwry and try to repeat the seguence of 
flashinS squares and tones. Increasing levels of difficulty 
■ale this gaae a true challenge 13.00 



Try to let the best score in this fan! liar poker dice 
Up to nine players lakes this gaM fun for the entire 

13.00 



Yippee: 

taM. 
asily. 

Specul: AU ikr€$ gaaes $8M 

All gaies are in BASIC. 32K Eitended Color Basic^^ required. 

Kcal lersion 2.0: Oie vour DIf nrinter to create per- 
sonalized calendars frow 1988 on. Each day has three lines 
of 15 characters each available for your own personal notes. 
OOX aach|ne language for fast response. 321 Eitended Color 
Basic required. 18.00 

Ail prices are cassette or disk. Canadian aoney saie as U.S. 
All others U.S. funds, iashington state residents add 7. SI 
sales tax. All shipping and handling included. 



Send check or loney order to: 



ling Cottage Industries 
1811 falley St. IS 
Poulsbo, n 08370 



Extended Color Basic is a registered tradeinark of Tandy Corp. 



35 PRINT "A HALF WAVELENGTH AN^TE 

NNAE WILL' : PRINT" HE ";FT;'^FEET " 

; IN; ^* INCHES" 

4 PRINT "AGAIN ."* : 

5U A$ = iNKKY$:IF AS = *"^ THEN 50 

60 IF A$=="N*' OR A$ = '^n'* THEN END 

ELSE 10 



Let's practice using the program by cal- 
culating the length of an antenna ' for a 
frequency of 10 MHz. I came up with 49 feet 
2.4 inches. Your result should show the same. 

Since we're going to build the dipole to 
operate at 28.5 MHz use the program and dis- 
cover how long our antenna should be. 
According to my calculations our antenna 
should measure 17 feet 3.15 inches in length 
(I rounded it a little). That's the length 
from point A to C in Figure One. 

Now that we know the length of our 
antenna, cut a piece of wire to that length. 
Attach insulators to each end of the wire. 
Find the center of the wire (point B in 
Figure One) and place another insulator there 
by cutting the wire. Connect the center con- 
ductor of the coax to one side of the dipole 
and the shield to the other side. 

The coax I'm using is 50 ohm coax which 
can be purchased at Radio Shack (along with 
everything else here). The impedance of the 
center feedpoint where the coax is attached 
is 75 ohms. This means that, even under ideal 
conditions, we will always have a 1 . 5 to 1 
mismatch (75 is 1.5 times 50). 



Connect the antenna 
SWR bridge (meter) in 
to do this SWR check 
mi t ting. If you're Jus 
the mail) don't worry 
going to measure the 
the antenna and 'prune 
though we used the 
tell us how long the 
antenna, it still must 
to get the best possi 
cause the formula c 
length in free space, 
the antenna will be af 
to other conductive 
jects . 
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formula and program to 

wire should be for our 
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ble match. This is be- 

alculates ar- antenna's 
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Measure the SWR and trim the antenna at 
the ends (points A and C) by removing about 
an inch at a time from the length. Be sure to 
remove an equal amount from both ends! After 
each trimming measure the SWR again until you 
reach 1.5 to 1. Once the antenna is trimmed 
it can be used on the air. 

Well, our dipole is built and seems to be 
working pretty well. Next time we'll add to 
our program and learn how to build a three 
element beam! Now that's exciting! 73 's de 
Mike Dooley KE4PC 
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SEEC: To Change 



Nancy Ewart 




One of the first things I found out about 
computers way back in the early 60 *s was that 
computer people took the English language and 
put totally new meanings to common words, 
with the end result that as a non-computer 
person trying to talk to a programmer, I 
found myself listening to a language that I 
thought I knew but that had totally no mean- 
ing. Even now, learning the vocabulary is 
often the hardest problem to solve. I know 
this puts off many people who would like to 
learn more of the capabilities of computers. 
Herewith, some definitions for programmers 
when readings those erudite articles.... 

Pseudo code: sort of an outline in English of 
the different parts of the program and what 
you want them to do. 

Source code: the program, in readable C, be- 
fore it has been compiled. 

Object code: the product of the compiler; the 
program translated into machine code. (Ah, 
the light dawns! The same source code run 
through different compilers produces machine 
specific code. That * s how you get port- 
ability . ) 

Relocatable object code: Object code after 
the compiler has translated the source code 
into machine code but the memory addresses 
have not been absolutely defined; only the 
offset (or relative) information is kept. 
The most common example would be Library 
functions before linking. 

Linker: the last step in compiling a C pro- 
gram; this is when the Library relocatable 
object code is added to the program. At this 
time the actual addresses are created for 
that program. 



Function: These are C's bui 
Every program must have one 
main( ) function that starts 
When you see source code witho 
know that it is intended to 
another program. You can use 
are already defined in a Li 
create your own library of func 
use in programs over and over 
can create functions for a spec 
EXAMPLE main( ) 

getf acts( ) ; 

sortfacts( ) ; 
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printf acts( ) ; 

A function must be defined someplace, at the 
end of the source code or included in a 
library. 

Argument: a value that is passed to a func- 
tion. EX getfacts(list) ; The value can be a 
single digit to a string. A function can have 
no arguments, (but you always include the 
parenthesis), or multiple arguments. EX 
add( a , b, c , d , e ) ; 

Library: There is a standard library that 
comes with the C Compiler. It can be changed 
and added to. This Library includes all the 
I/O functions like printf ( ) in relocatable 
object code. 

Compile time: what happens while you are 
running your source code through the com- 
piler ... usually errors, frequently fatal. 

Run time: what happens when you are running 
your program after compilation . . . sometimes 
unexpected. 

Debug: when you change your source code to 
get rid of the errors. 

(Then there is object-oriented programming 
that the slick magazines are talking about. 
This appears to be a way of defining classes 
of things hierarchically so that you propose 
actions related to the class before defining 
the unique object that will be affected. C-f + 
is the language that handles data abstraction 
and object-oriented programming.) 

SOURCES 

All this, of course, is dependant upon a 
compiler. Microware's C Compiler for OS-9, 
published by Radio Shack can be obtained 
through Express Order at most Radio Shack 
stores for $99.95. (Cat. # 26-3038 CMC) In 
addition, there are various shareware and 
public domain compiler offerings on Compu- 
Serve and the like. 

A very helpful addition to the compiler is 
the C-Programmer*s Tool Kit, #9 from the OS-9 
User Group Library. The command cb is a 
pretty printer. If you type your source code 
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Version 2 of CSG IMS has been delayed but you should 
receive it by the time you get this newsletter. 

MSF 

The source code for MSF is now available for those who 
are developing MSDos disk drivers for other 0S9 computers. 
The pice is $45. 

Users of MSF (the MSDos file manager) are still en- 
count^ng problems when accessing an MSDos disk as an 
0S9 disk. The most common mistake is when an MSDos disk 
is referenced by the 0S9 drive name. For example: DIR /Dl 
instead of DIR /B (NOTE: there is a new version of MSDIR 
renamed to DIR which will work with both 0S9 and MSDos 
disks). Another mistake is to leave a default directory on an 
0S9 disk and then replace it with an MSDos disk. When a 
command cannot be found or you forget to specify the drive, 
the default directory will be accessed. 

As discussed in a previous newsletter, these problems 
occur because 0S9 and MSDos use a different disk sector 
size. When an MSDos 5 12 byte sector is read into an 0S9 256 
byte buffer the buffer overflows into system memory. In the 
worst case this will cause a system crash but it could create 
other havoc as well. 

The 0S9 file manager which allocates the buffers for 0S9 
sectors (256 bytes) is RBF. If we patch RBF to allocate 512 
byte sector buffers so system memory will be protected (ex- 
cept from Japanese MSDos disks which use 1024 byte sec- 
tors). More system space will be used for file buffers so you 
may not be able to run as many processes or windows or have 
as many files open. This example is for the following version 
of RBF. 



0S9:ident rbf -m 



Header for: 
Module size: 
Module CRC: 
Hdr parity: 
Edition: 
Ty/La At/Rv: 
File Man mod. 



RBF 
$122E 
$EFBE13 
$D4 
$1C 
$D1 $81 
6809 obj, 



#4654 
(Good) 

#28 



re-en, R/0 



The BOOTPATCH command will patch the boot file and 
update the CRC. You should run BOOTPATCH on a backup 
of your system disk because if you make the wrong patch, 
your disk could become non-bootable. 

Place your system disk in drive /dO and your backup sys- 
tem disk in /dl. Make sure you have the BOOTPATCH 
program (you will have to enter and assemble the program 
listing below) in your CMDS directory. Enter the following 
commands. 

0S9:bootpatch /dl/os9boot #40k 

1 rbf 

c 2bb 01 02 

c 73b 01 02 

q 

0S9: 

Now boot the backup system disk so RBF will allocate 512 
byte buffers for all files. 



ER 

If you have a different version of RBF you can still make 
the patch if you have a disassembler or debugger such as 
ERINA. Simply find the two places in the code where there 
is a LDD #$0100 followed closely by an OS9 F$SR1MEM 
and an 0S9 F$SRQMEM. Use BOOTPATCH to change 
LDD #$0100 to LDD #$0200. NOTE: On the Smoke Signal 
VAR computer the 0S9 calls in RBF may be JSR instructions. 



* Bootpatch.a - patch a module on disk 
******************************************************* 

* (c) Clearbrook Software Group 

* Date: October 1988 

* Author: Paul Kehler 

if pi 

use /def s/os9def s 

endc 

Edition equ 1 

LF equ 10 line feed 

CR equ 13 carriage return 

SP equ 32 space 

BUFSIZE equ 256 

mod modlen,modname,PRGRM+OBJCT,REENT+l,modstrt,memsiz 

modname fcs 'bootpatch' 
fcb edition 

file rmb 1 path number 

chflag rmb 1 NE means CRC needs update 

rewrite rmb 1 NE means file needs update 

offset rmb 2 change offset 

oldval rmb 1 value to change 

newval rmb 1 new value 

module rmb 2 address of module in memory 

filend rmb 2 pointer to end of file buffer 

filesize rmb 2 size of file 

buf rmb BUFSIZE 

filebuf rmb 2000 actually to end of memory 

stack rmb 200 

memsiz equ . 

modstrt clra the start of the program 

clrb 

stb 

stb <chflag 

stb <rewrite 
modstO Idb ,x+ 

cmpb #CR end of name? 

Ibeq modst2 ..yes, no options 

cmpb tSP 

beq modStO 

cmpb ♦ ' - 

beq modstl ..check option 

leax -l,x 

tst <file 

bne twonames . .two file names 

Ida #3 open for update 

0S9 I$OPEN open the file 

bcs error 

sta <file 

Idb #SS.Size 

pshs X 

pshs u,x 

0S9 I$GETSTT get file size 

bcs error ..report error 

stu , s 

Idu 2,s 

stx -2,s is file too large? 

bne nomem . .yes 

Idd ,s get file size 

std <filesize 

leax filebuf, u 

stx <module default link to first module 

addd <filesize 

bcs nomem . .not enough memory 

std <filend save pointer to end of file 

tddd «200 

bcs nomem . .not enough memory 

pshs d 

cmps , S++ is there room for the stack 

bio nomem ..not enough memory 

Idy , s get file size 

Idx <module get buffer pointer 

Ida <file 

0S9 I$READ read the file 

bcs error 

Idd ,x 

cmpd #$87cd is it module? 

bne badfile 

leas 4,s 



puis X 

bra raodstO 
nomera leax moremem, per 
nomeral bsr writeln 

clrb 

OS9 F$EXIT 
badfile leax notmod,pcr 

bra nomeml 



modstl Idb ,x+ 
cmpb #CR 
beq modst2 
cmpb #SP 
Ibeq modstO 
cmpb # ' ? 

beq modsyn . .yes, 
Ibra modstO 



report syntax 



twonames leax namerr,pcr 

bsr writeln 
modsyn bsr syntax show command syntax 

clrb 
error OS9 F$Exit 

syntax pshs x,b 
leax synmsg,pcr 
bsr writeln 
puis x,b,pcr 

writeln Idy fsynlen 
Ida #1 error path 
0S9 I$Writln 
rts 

skipsp Idb ,x+ 
cmpb tSP 
beq skipsp 
Ibra toupper 

skipspl bsr skipsp 
leax -l,x 

rts 

modst2 tst <file was a file specified 

bne modst25 . .yes 

leax nomsg,pcr 

bsr writeln 

bra modsyn 
modst25 leax buf,u point to buffer 

Idy #BUFSIZE 

clra 

os9 l$READLN read a command 

bcs errorl 

bsr skipsp skip leading spaces 

cmpb #'L is it link? 

Ibeq link 

cmpb ♦ ' C 

beq change 

cmpb #'Q 

beq quit 

cmpb tCR 

beq modst25 

leax unknown, per 
modst28 Ibsr writeln 

bra modst25 

errorl cmpb #E$EOF is it end of file? 
beq quit . .yes, quit 
0S9 F$EXIT 

quit bsr changed check if module was changed 

Idb <rewrite has any change been made? 

beq quit 9 . .no 

pshs u 

Idx #0 

tfr x,u 

Ida <file 

0S9 I$SEEK rewind to beginning of file 

puis u 

bcs quit9 . .error 

leax filebuf,u point to data 

Idy <filesize 

0S9 I$WRITE write the file back 

bcs quit9 

clrb 
quit9 0S9 F$EXIT 

* update the CRC of changed module 
changed pshs d,x,y,u 

Idb hflag has module changed? 

beq changed9 . .no 

stb <rewrite file needs update 

clr <chflag next module not changed yet 

Idx <module 

Ida *8 

clrb 
changedl eorb ,x+ find header parity 

deca 

bne changedl 

comb 

stb ,x update header parity 

Idx <module 

Idd 2,x get module size 

subd «3 

leau d,x point to crc 

tfr d,y module size less accumulator 

Idb #$FF 

stb ,u 



stb l,u 
stb 2,u 

0S9 F$CRC calculate the new CRC 
com ,u 
com l,u 
com 2,u 
changed9 puis d,x,y,u,pc 

change bsr gethex get offset 

ibcs modst25 

std <offset 

bsr gethex get old value 

Ibcs modst25 

stb <oldval 

bsr gethex get new value 

Ibcs modst25 

stb <newval 

Idx <module point to module 

Idd <offset 

cmpd 2,x 

bio changel 

leax outofrng,pcr .. offset out of range 

Ibra modst28 
changel leax d,x point to byte to change 

Idb <oldval 

cmpb ,x 

beq change2 

leax diff rent, per 

Ibra modst28 . .print warning 
change2 Idb <newval 

stb ,x 

Idb #1 

stb <chflag set flag 

Ibra modst25 

gethex clr ,-s 

clr ,-s 

Ibsr skipsp 

cmpb fCR 

beq gethex2S ..no number 
gethex21 cmpb #CR 

beq gethex29 ..number complete 

cmpb #SP 

beq gethex29 . .number complete 

cmpb ♦ ' 

bio gethex25 , .error 

cmpb ♦ ' 9 

bis gethex22 . .0-9 

andb ♦$5f convert to upper case 

cmpb #'A 

bio gethex25 . .error 

cmpb #'F 

bhi gethex25 ..error 

subb ♦'A-'O-lO 
gethex22 subb #'0 

Isl l,s 

rol , s 

Isl l,s 

rol , s 

Isl l,s 

rol , s 

Isl l,s 

rol , s 

orb 1 , s 

stb l,s 

Idb ,x+ get next character 

bra gethex21 
gethex25 leax hexmsg,pcr 

Ibsr writeln 

comb set carry 
gethex29 puis d,pcr return hex value 

link Ibsr changed check if module changed 

Ibsr skipspl 

pshs x 
linkO Idb ,x 

cmpb #SP 

bis linkOl 

bsr toupper convert name to upper case 

stb ,x+ 

bra linkO 
linkOl Idb -l,x 

orb #$80 

stb -l,x set hi bit on last byte 

leax filebuf,u 

pshs d,x 

Idd ,x 

cmpd #$87cd is it proper module? 

bne link99 . .no 
linkl stx , s save pointer to current module 

tfr x,d 

addd 2,x get module size 

std 2,s point to next module 

Idd 4,x 



leax d,x point to current module name 

Idy 4, s link name 
link2 Idb ,x+ 

bsr toupper 

cmpb ,y+ 

bne links 

tstb 

bpl link2 

Idx ,s ..module found 

stx <module 

leas 6, s 

Ibra modst25 go for next command 
link3 Idx 2,s 

empx <filend is it end of file? 

bio linkl try next module 
link99 leax notfound,pcr 

leas 6,s fix stack 

Ibra modst28 and go report error 

* convert B to upper case 

* bit 7 not affected 
toupper pshs b 

andb #$7f mask bit 7 
cmpb # ' a 
bio toupper 1 
cmpb # ' z 
bhi toupper 1 

andb #$5f convert to upper ease 
toupperl orb #$80 set hi bit 
andb , s+ 
rts 

unknown fee "Unknown command!" 

fcb CR 
moremem fee "Not enough memory to load 
file!" 

fcb CR 
namerr fee "Only one file allowed!" 

fcb CR 
nomsg fee "No file specified!" 

fcb CR 
hexmsg fee "Non hex character encountered!" 

fcb CR 
outofrng fee "Offset is not within module!" 

fcb CR 
diff rent fee "** old value not the same, 
not patched **" 

fcb CR 
not found fee "Module not found!" 

fcb CR 
notmod fee "File does not contain 
module (s) !" 

fcb CR 

synmsg 

fee "Syntax: bootpatch [opts] <filename> 
[opts]" 

fcb LF 

fee " where opts are: -? for help" 

fcb LF 

fee " <filename> is the name of the file 
containing the module to" 

fcb LF 

fee " be patched. NOTE: this is 
different from MODPATCH" 

fcb LF,LF 

fee " Commands : L <module> link to the 
specified module in the file" 

fcb LF 

fee " C <offset> <old value> 

<new value> change the old value" 

fcb LF 

fee " at offset to new 

value . " 

fcb LF 

fee " Q quit" 

fcb LF,LF 

fee " The CRC of the module will be 
automatically updated when you link" 

fcb LF 

fee " to a new module or quit . " 

fcb LF,CR 

synlen equ * -synmsg 

emod 
modlen equ * 

end 
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without indentations and commonly accepted 
spacing, you can then send it through cb, and 
lo and behold, it is ali formatted for you - 
which also points up errors. 

The command lib will split up the Library 
into the separate relocatable object files so 
that changes can be made. Other neat commands 
are findfunc, which goes through and finds 
all your functions for you, and xc , a "C" 
concordance utility, that helps you sort out 
what you have . 

The report on FoxWare CCENV(R) will have to 
be delayed, as I have not received my copy 
yet . 

ODDS AND ENDS 

Donald Hicks of Mobile, Alabama writes that 
what he really wanted to suggest was to 
change "/dl" to "..." "so that reference is 
made to the (anomymous) root directory under 
all circumstances - probably the best alter- 
native (so as to keep it portable)," He adds 
the warning "that this might not be true if 
your C stuff is down in some subdirectory on 
your hard disk somewhere." 

PLANS FOR AN OUTLINER 

Those of you who want a challenge (and even 
if you don*t), please think about an outliner 
....a simple outliner, more like PC Outline 
than like Think Tank in the beginning. Please 
send pseudo code describing how you would go 
about some aspect of the program; include a 
couple of functions to illustrate your pseudo 
code . 
Send to : 

Nancy Ewart 

Book Trader ( SEEC ) 

1789 Hooper Ave. 

Toms River, NJ 08753 

This source code, written for a TRS80 Model 
4, was interesting to me as a challenge in 
porting code from one machine to the CoCo . 
But there is more to the program than just a 
simple loan calculation. Walt has been play- 
ing around with code that sends output to the 
screen AND output to the printer in the same 
code. When he found out how to do it on the 
Model 4, it was simple to figure out how to 
do it in OS-9. 

This is Walt Gabriel's code as he wrote it 
for his machine and his compiler. 

On line 42 change perror to ferror 

Delete line 62 

I just dropped out all references to date and 
time for the nonce. Actually there were very 
few changes that were necessary. Because I 
wanted to make this usable for any kind of 
loan, I changed some of the terminology to 
the more generic word LOAN. Walt had to 
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is usually the question 



split between the 
then he had a long 

code for his computer 

what he had come up 

OS-9 it was all so 

to the printer. Now 

oiild be done is to 

that you input amount 

nt ; number of total 

let it back out the 

the payment is going 

h for principal. That 

1 want answered. 



Walt brought his machine to local C SIG 
meeting to demonstrate his compiler. I was 
interested in the bells and whistles avail- 
able on other machines. When he runs the 
compiler, the application comes up in a nice 
menu, highlight selectable. But most inter- 
esting, as it compiles the code, it does a 
"dump" of the hexadecimal code. 



¥ NEW *:tc NEW ** NEW ** NEW :*:* NEW ^t NEW ** J 

* VED OS-9 Text Editor ? 

X t 

J Haven't you been fooling with line editors J 
J written for someone using a Teletype long -•i 

* enough? Or did you get a mickey mouse editor m 
^ written in a high-level language which does ;J 
X screen refreshes so slowly that you can count J 
J the characters as they are printed, yell fret -¥• 

* no more — VED is here! Our amazing new editor ^ 
X is less than 8k long, but since it is written in ^ 
X fastp efficient 6809 assembler and takesj 
^ advantage of OS-9's system resources it lacks -k 
^ no features: 52,000 character bufferj^J 
Joverstrike/insert modej adjustable tabsjj 
J definable (and saveable) macro keys; word* 
-k delete; block move, copy and delete; auto- ^ 
X indent mode, global changes, plus much more. J 
J VED is not a word-processor, but formatting* 

* commands will let it be used to do letters, -n 

■* * L 

^ etc. (however, the best route is to use one of J 
J the many text formatters available). 1/OJ 

* commands include block save/print, append, etc. * 
t All files Br^ ASCII for complete filej 
X compatibility. But that's not all: everything* 
X VED does is FAST. No more delays! And the* 

* single key-stroke commands are very easy to^ 
X learn; but if you forget on-line help isj 



X available. 

* 
* 
* 
* 
* 



12eK OS-9 Level 2 $24.95 i 

* 
* 

* Sorry, no credit cards — enclose check or money* 

* order plus *2.00 shipping and handling. Complete* 

* catalogue available — send 4»l-00. ^ 

* * 

* * 
X Bob VBin der Poel Software * 

X 17435-57 Avenutr X 

X Edmonton, Alberta J 

X Canada T6M lEl * 
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/* ZMORTl/CCC 09/11/88 */ 

/* This is\a DEVELOPMENTAL version */ 

tinclude stdio/h 

finclude math/h /* Required for atof ( ) */ 

main(ac,av) 

int ac ; 

char ♦avt ] ; 

float in = 0; 
float pay = 0; 
float loan = 0; 
float ipd = 0; 
float ppd =0; 
int i = 1 ; 

long tod; 
char bufl|81]; 
char tbuf [9] ; 

FILE *ptr,*fopen( ) ; 

/* initialization of tbuf and &tod */ 
syBdate( tbuf) ; 
time(&tod) ; 

pay = atof(av(lJ); 
in = atof (av[2J ); 
loan = atof(av[3]); 

/* Information to be on screen */ 

puts( "Written by Walt Gabriel, 20 Wren Place, Toms River, N,J., 08753"); 

puts(" 201 240-5084"); 

strcpy(bufl, ( FILE )); /*disepays file name */ 

strcatibufl , "Compiled on "); 

strcat(bufl, ( DATE }); 

puts(bufl )*; 

if (ac == 4) /* Note count is 4 - 0,1,2,3 */ 

if ((ptr = fopen("*pr","w+")) == NULL) 

perror( "fopen error"); exit(-l); 

f puts ("MORTGAGE PAYOUT TABLE", ptr); 

fputs(" \n\n",ptr); 

fprintf (ptr, "Original Loan Value %8 . 2f \n" , loan) ; 

fprintf (ptr, "Annual Interest %6 ♦ 2f \n" , in) ; 

fprintf (ptr, "Monthly Payment %6 . 2f \n\n" ,pay ) ; 

fputs(" PAYMENT PRINCIPAL PRINCIPAL INTEREST \n",ptrj; 
fputs( "NUMBER REMAINING PAID PAID \n\n",ptr); 

while (loan >=0) 

/* computation */ 

ipd = loan * in/1200; 
ppd = pay - ipd; 
loan = loan - ppd; 

fprintf (ptr," %d %8.2f %6.2f X6.2f \n" , i++ , loan, ppd, ipd) ; 

fputs(ctime(&tod) ,ptr; /*prints date, time */ 
fclose(ptr ) ; 

else 

puts( "DATA ENTRY FORMAT\n" ) ; 

puts("DMORTPAY PAYMENT/MONTH ANNUAL INTEREST LOAN\n" ) ; 

puts ("EXAMPLE: MORTPAY 132.98 8.5 5000 \n" ) ; 
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070: 
071: 

Here are the changes that I made so that the source code would compile on my 
CoCo. 

On line 003 #include <stdio.h> 

On line 004 #include <math.h> 

double atof(); /^between lines 13 & 14 */ 

Delete lines 16, 17, 18 

pffinit(); /* insert on line 21 ♦/ 

Delete lines 22, 23, 24 

Delete lines 34, 35, 36, 37 

On line 41 change "*pr" to "/p" 
On line 42 change perror to terror 

Delete line 62 




6-2-1 
$83.25 

SAVE 15% FROM LIST PRICE 

Just in time for holiday giving it's 6-2-1! 
"6-2-1" is our new program to save your 
money! Six back issues of Clipboard, a two- 
year subscription to Clipboard and one year 
of ClipDisk. Normally $97.97, now you can 
save 15%, only $83 25! Just write in 
"6-2-1 " on the order form on page 18. 
MC - Visa - Discov er accepted. 



And now you can phone in your order! 
We accept VISA, MasterCard and 
Discover - (716) 679-0126 — 9 a.m. 
to 9 p.m. Monday thru Saturday! 



V/SA 
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SPECIAL DEAL ON 500 
PROGRAMS IS BACK! 



BACK BY POPULAR DEMAND! GET OUR LATEST 
50 DISKS OR TAPES FULL OF OVER 500 PROGRAMS. 
HERE IS WHAT YOU'LL RECEIVE: 

•Over 250 Utility/Home Application Programs including a 
Word Processor, Database, Spreadsheet, Disk Utilities, 
Business Software, Electronics Series, Educational Pro- 
grams for Kids, plus much more! 

•Over 200 exciting games including King Pede, Kron, Star 
Trek, Flight Simulator, Wizard, Horse Races, Football, plus 
much more. 

•Over 30 adventures including Rambo, Haunted House, 
Power Sword, Skid Row, plus 32k graphic adventures. 

Individual issues sell for '9°« each or '450° 
for all 50. We slashed the price to 

only '150*^°! 



COOLDOWNTOOURSUMMERPRICES 
ON SUBSCRIFTION SOFTWARE 



THERE IS NO BETTER WAY TO ENJOY THE SUMMER THAN 
TREATING YOUR COLOR COMPUTER TO 10 READYTO RUN 
PROGRAMS EACH MONTH GET 12 DISKS OR TAPES A YEAR 
CONTAINING OVER 120 QUAL ITY PROGRAMS A SUBSCRIPTION 
TO T & D SOFTWARE CONSISTS OF 10 READYTO-IOAD PRO- 
GRAMS DELIVERED BY FIRST CLASS MAIL EVERY MONTH. 

NO WE ARE NOT THE SAME AS THE RAINBOW ON TAPE IN 
FACT MANY SUBSCRIBERS HAVE WRITTEN IN AND SAID THAT 
WE ARE MUCH BETTER THAN RAINBOW ON TAPE! 



REG. M50 




*150^ 




PRICES - 

TAPE 



• •THIS MONTH ONLY^^ 




Buy this package of 500 

programs and receive a free 

6 nnonth subscription. 



RAINBOW 

CERTIFICATION 
SEAL 



THIS 
OR DISK MONTH ONLY 
1 YEAR (12 issues) JWrWT 60 00 

6 MO. (6 issues) AQfXKf 35 00 

1 ISSUE ^«r 8 00 

Michigan Rt-iidenls Add 4'*.b 
Overseas Add $10 to Subscription Price 
Personal Checks We'come! 



• Available on COCO 1.2 and 3 
it Inclutles Dociimentalion 

• Over 4,b00 Sdtistied 
Customers 

• Baf;k Issues Available (• roni 
July '82 (Over 720 Programs) 



Maft«rCgrd 



PLEASE SPECIFY TAPE OR DISK 



T & D SUBSCRIPTION SOFTWARE, 2490 MILES STANDISH DR, HOLLAND, Mi 49424 (616) 399-9648 
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T&D Subscription 
Software, 

an advertiser 
in this magazine, 

wants to introduce you 
to their variety of 

inexpensive software 
by giving you a: 

FREE Disk or Tape 

Filled with 10 programs 

1 coupon per household 

Circle one: TAPE DISK 
Mail this coupon to: 

T&D Free Offer 

P.O. Box 1256 
Holland, Ml 49423 
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STOCK MARKET PORTFOLIO 
FOR THE COLOR COMPUTER 



Saym 10Z on Stock 
Market Por folio wit/i 
this Clipboard Coupon 



Paparis Enterprises 
700 York St. 
WUliamsburg, VA 23185 



MARTY -5 RUBBER STAMP D I 5C01 



We can now offer COLORS for many nylon cartridU^e 
ribbons. Our RAINBOW-PAK contaip 6 different 
colored ribbons. Write for prices. Specify your 
printer's name & model. 

Marty's Rubber Stamp Shop 
47 South Second St. 
i SAINT CLAIR, PA 17970 

' (717) 429-1052 
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S«v» lex on C.8.S. 

— Hith thl» coupon — ^ 

Cieari3rcK)k^$oftyra Group 



Information 

Management 

System 



CSG IMS is a full featured relational datat>asa manager 
for ttie Color Computer and 0S9. 




• IntaractW* a 
da'iJib '•• for quick qtivrtot. 

• Include* • ttructursd 
oon^vd l«nou«0* 
supporting program moduita 
with luN paramatar paaairtg 
•rtd raoiralon. 



• Utar daflr>ad aeraan ar>d 
raporl formata. 

• Racord. Indax, artd lUa aizaa 
ara vlrtuaKy ur>llml1ad. 

• Taxt. BCD noatir>o po«i4 
(14 digits). ahona/H! long 
lnl*gar, and data data typaa. 

CSOIMSIor CoCoarS OSS LI/2 (sInglauMr) $169.95 

CSOlMSfof O$9L2ore8000(rmirauaar) »499.00 

CSQ IMS damo with manual UaOO 

OTHER CSQ PRODUCTS: 

ERiNA Symbotie Usar-moda Oabuggar lor 0S9 $69.00 

SERINA Syatam-moda Dabuggar for 0S9 Laval 2 $139 00 

MSF MS-DOS FUaM«nagar for CoCoa/OS9L2 $45.00 

MSF with S0ISK3 $65.00 

Shipping - N. Amarlea: $5. 0«^araaas: $10 

Clearl>rook Sotttware Gro.ip. Inc. 

U.S : P.O. BOK 8000^99, Sumas^VA 98295 

CANADA: P.O. Bon 9000-499. Abbotaford. B.C. V2S6H1 

Ptione:(604)853>911S 




SAVE $15 
WITH THIS COUPON 

ON A SCSI INTERFACE 
WITH R.T.C. 

OR $15 ON A 2 CHANNEL 
DUALCOMM BOARD 

FROM: 



KEN-TON 
ELECTRONICS 

187 GREEN ACRES RD. 
TONAWANDA, NY 14150 



T 






Y 






<itl}f» certlfftatc eut!tle« 



off 

tlfclr tttxt purcl|«0C. 

SNnit-trtinHfernltle anh nnt ualib uiitl; any 
otlicr »nle jtrfccB at tcrtlfftatca. 

Q!l|l« offer tx\»itt«i_S'^t/,j.')f?. 

Co Co ^ C //"^ ^<> ^ftr 



KING CQTTftGE INDUSTRIES 

Include this coupon with any 

order before Christmas and 

receive one free blank diskette 



1 . »- 



Save $5.00 on 

R.A.D. PRODUCTS 

Text form 



Exp. 12/31/88 



33 



/ 



!t 



CCMDisk Service 



Unte typing in ^" 
those J-o-n-g program 
listings? Don't worry, 
be Happy! Subscribe f 
to ClipDiRk today! 



\ 



F^RESENTS 



CUpDish 



FULL YEAR (6 issues) Only $49.95 ! 




Now all the BASIC, C, BASIC09, Assembly Language and 0S9 
programs you see in CoCo Clipboard Magazine are available on 
disk. With ClipDisk you* 11 save time and be more productive 
computing with your Color Computer. 

A subscription to ClipDisk is $49.95 for 6 issues. Single 
issues are available as well for just $9.95. Of course in 
order to get the full benefit of ClipDisk you'll need the 
corresponding issue of CoCo Clipboard Magazine. All 
ClipDisks are mailed first class. 



\ 



So don't delay, get your subscript ion in today! 



J 



I've enclosed (check one) ( ) 1 year of ClipDisk $49.95 

( ) single copy 9.95 

Specify month desired 



Canadian customers can also obtain ClipDisk for $49.95 

when paid in U.S. Funds. ♦*****.****.*♦**.***.♦*******.******.***♦•**** 

* o - 5> - 1 

♦ 
- X r,AVe 15X FFfOM Li;5T PRICF 

_ 5 Just In t1n>o for hoUday giving It's 

♦ 6 2-1! "6-21" Is our new program to save 
J your money! 6 back Issues of Clipboard, a 
5 2 year subscription to Clipboard and 1 
J year of CUpnisk. Normally $97.95 now you 

„. I can save 15X only $83.25! Just write in 

t "6-2-1" on the order form on page 18. 



Name: ._ - 

Address: ._ 

City: 

State/Prov: 

Zip/Postal Code 



i MC-iVl3aj:PJAcqver_ACJ?«J>tod.. I 

Please charge my ptjrchase to my (circle) VISA / MasterCard / Discover Card. 
MasterCard Interbank Number | j J |^ | 



^S^II^^S 



Card« - 

Exp. Date — 

Signature - 

PLEASEJI01E: All chatgn card orders are handled coiulcsy ot pjJJneCompyte!_S^.ces.You 
charle card hilling will show OrvLine CompjJjeis and NOl CoCo Cliphoard Magazine 

CoCo Ciipbosird Ms^Qaxinc 

:^1Ml U.S. 20, Box 5, rredonin, flY 14063 



The Gamer's Connection! 



The ONL Y magazine devoted so/e/y to ttie CoCo gaming woridi 



77?a Gamer's Connection, a great 
new magazine devoted solely to 
the Color Computer world is 
finally here! Filled from cover to 
cover with high quality programs, 
articles, tutorials, advice, hints 
and tips, reviews, and more 
reviews - The Connection is 
truely the best and most current 
source of CoCo information 
anywhere! Also found inside are 
columns on BASIC programming, 
machine language instruction, 
program design, and so much 
more! All presented to you in an 
enjoyable and clear fashion... 




Right now you can take advantage of our introductory 
special and save on our subscription rates. You can 
receive a full year (six issues) of The Gamer's 
Connection for only $15.00 ($18.00 Canadian residents 
(US funds)). This special offer is in effect only for a 
very limited time, so act now and start your subscrip- 
tion to The Gamer's Connection today! 



Please send your check or money order to: 

The Gamer's Connection - Dept. 0, P.O. Box 102, Grafton, Wl 53024 



yr 



TN 



Real BASIC for 0S9! 




OS-9 LEVEL TWO VR. 02.00.01 

COPYRIGHT IQM BY 

MICROWARE SYSTEMS CORP. 

LICENSED TO TANDY CORP. 

ALL RIGHTS RESERVED 

July 11, IMS 14:37:30 

Shell 

OS9: xnruMl* /wS Iyp«s0 

OSS: iniz /wS 

089: r»b «»»Wwft S 

SOOT 




RSB COPR. 19S8 BURKE S BURKE 
DISK EXTENDED COLOR BASIC 2.1 
COPR. 19B2. 1986 BY TANDY 
UNDER LICENSE FROM MICROSOFT 
AND MICROWARE SYSTEMS CORP. 

OK 

LOAD -OEMO- 

OK 

LIST 

10 PMOOE 4:SCREEN 1,1 

20 X=RN0(2SC)-1:Y=RND(192)-1 

30 XS=RND(25«-X).1:YS=RND(192-Y)-1 

40 LINE (X.YHX*XS.Y+YS).PSET.BF 




Welcome to . 



R. S. B. 



8m RSB. and oth«r Burk« & 

Burk« products «t th« Princeton 

Rainbowf*»t. Don't mba our Hard 

Disk Saminari 



There Is nothing wrong with your Color Computer Do not attempt to adjust It, The BASIC you know and love Is now 
running under Level 2 OS9 windows. You are In command. 

Burke & Burke is proud to present another OS9 programming language: Disk Extended Color BASIC. 

You've probably heard of this language. It's the one your Color Computer was born with. We're talking PMODE. DIR, COLOR, 
RENUM. PLAY and other familiar words. Under Level 2 OS9. In as many windows as your memory lets you create. 

Our R.S.B. software creates a complete. OS9 -compatible version of Disk Extended Color BASIC bv reading your CoCo's ROM chips 
Burke & Burke has added new software to give you OSQ-style graphics, sound, orinter. and disk I/O. Of course, you cant use R.S.B. to 
run machine language programs, and some BASIC commands work slightly differently under R.S.B. 

RSB loads and saves files using OS9's file format, so we've also included utilities to transfer BASIC programs and data files between 
o'S9 and BASIC disks. Your BASIC programs can take advantage of great OS9 features like hard disks, no-halt Hoppies. multi -tasking, 
and 2 MHz operation. 

You must have a CoCo 3 with at least 1 28K RAM. and a floppy controller with Disk Extended Color BASIC 1 .0. 1 .1 . 2.0. or 2.1 ROM. or 
CoCo 3 CDOS ROM, to use R.S.B. \ y 

Work3 with //V _ ^ V\ Runs In I2SK; 



all hard disk 
systems I 



5I2K 
preferred. 



Hard Dis k Interfaces 

We've sold hundreds of our affordable, 
high-performance hard disk interfaces to 
Color Computer enthualaata worldwidel 

Each includes an anodlzed housing, 100 page 
user manual, and software for use with OS9. 
The CoCo XT-RTC adds a battery-powered 
real time clock / calendar for OS9 and BASIC 

CoCo XT $69.95 

CoCo XT'RTC $99.95 



pfher SASI Hard Olsk Systems/ ^ J 



^ 



Facts 



VTT Anawertn _ 
fc * ' some common^ 
queationm mbouC 
the CoCo XT. 






XT- ROM: Instaii XT-ROM In your hard 

^ disk oontroliar's BIOS ROM aockat. Ity 

^automatically boota and raboots^ 

OS9 from your hard dlak^ 

$19.95 



TPgff-Z/g 

i/ow BASIC runs hard drIvesS 
big floppies, and morel 



Burke & Burke has l^een offering our innovative line of Color 

Computer products to the public for one year now. Our 

customers often thank us for the fine service and support that we 

have given them. Now it's our turn to say. "THANK YOUI" 

What started out as a dream has become reality at Burke & 

Burke t)ecause of you and the hundreds of customers that have 

purchased our products in 1988. We thank you, above all. for 

the priceless recommendations and indorsements that many 

of you have given other CoCo users. 



A true "NO HALT" hard diak ayatem 
Controla 1 or 2 hard drivea 
Full ECC and ORG error correction 
Average acceaa 30% faster than SASI 
Uaea PC-type hard diak controllera & drivea 
Doea not uae or diaable interrupts 
Compatible with moat RS-232 interfacea 
20 Meg ayatem coat: under $450 
Requires Multi-PAK or **electrk;'* Y-cable 

Buy a driva. Waatarn Digital oontrollar, and 

oaaa from tha PC daalar of your oholoa. 

Plug tham Into tha CoCo XT. plug tha 

CoCo XT into your Multl-PAK, and 

Install tha OS9 or BASIC ^ 

aoftwara. Praatoi 



HYPER-I/O modifies the RS-DOS BASIC In 
your CoCo 1, 2. or 3 to provide a '*Dynamlc 
Disk Interface". Use your existing BASIC and 
RS-OOS software with hard disk interfaces 
(CoCo XT, DISTO, LR). RAM Disks, and any 
mix of floppy drives from 160K to 720K each. 

Fully RESET protected, user configurable, 
.expandable, EPROM-able HYPER-I/O V2.6y 



Our sincere thanks, too, go out to the magazine publishersj 
SIG / BBS operators, club officers, and Color Computer^ 
dealers who have provided us with the means to 
promote, demonstrate, or support our products^ 

Wfiank J^ouf 

and Season's Greetings, 



i OS9 Utilities 

Wild & MV Version 2.1 

Use "wildcards" with most OS9 



f-$2t^^Sl 



vHYPER-lll (Adda RAM Disk and/ 

Print Spooler for CoCo 3)^ 

$12.95 



P.O. Box 1283 Palatine, IL 60078-1283 (312) 397-2898 



commands, or rearrange your directory 

tree. Features recursive directory 

searches. A hard disk must! $19.95 

EZGen Version 1.04 

Powerful OS9 bootfile editor. Change ^ 

module names, add or delete 

modules, patch bytes, or 

.rearrange modules. Works on^ 

other files, too. $19.95. ^ 



ILLINOIS RESIDENTS PLEASE ADD 7% SALES TAX. COD'a 

add $2.20. Shipping (within the USA) $2.00 per CoCo XT; 

$1.50 per disk or ROM. Please allow 2 weeka for delivery 

(overnight delivery also available for In-atock itema). 

Telephone orders accepted (312) 397-2898. 





Multi-Vue Icon Editor 



Randy Krippner 





Multi-Vue is a fascinating program. It has 
drawbacks, of course, but it is still one of 
the most interesting programs to come along 
for the Coco 3. One of Multi-Vue 's features 
is that it permits a program to be run by 
simply clicking on an icon. 

When you do a directory of an 0S9 disk 
under Multi-Vue by clicking on one of the 

Multi-Vue displays the 
together with an icon for 



disk 



drive icons, 
files on the disk, 
each file. 

Normally these icons are the standard 
Multi-Vue default icons. But other icons can 
be created by the user for the purpose of 
identifying programs and making them into 
"point and click" executable programs. 

Making a program runnable from the Multi- 
Vue directory display by clicking on an icon 
is easy. You need two things; an icon and an 
Application Information File, or AIF. 

The AIF is a special file to Multi-Vue. 
When MV does a directory of a disk, it looks 
for files which are preceded by the char- 
acters "aif.". These files give Multi-Vue the 
information it needs in order to properly 
handle a particular program or data file. It 
contains information that tells Multi-Vue the 
name (pathlist) of the program or file, how 
much memory it requires, what type of window 
the program needs, how large the window must 
be, etc. It also contains the pathlist of the 
icon to be displayed. When Multi-Vue does a 
directory of a disk, it does not list the 
actual AIFs on the disk. Instead it displays 
the icon specified in the AIF above the name 
of the program listed in the AIF. It's all 
very simple, really. Unfortunately, Tandy and 
Microware complicated things by failing to 
provide a way to create new icons. 

There are icon editors available in the 
public domain on CompuServe, but not everyone 
has access to them. So IconEdit was born. 

IconEdit is a program that will let you 
draw your own icons for Multi-Vue. It will 
also create new AIFs to make programs into 
"auto-run" programs that can be executed 
under Multi-Vue by double clicking on an 
icon. IconEdit requires Multi-Vue (of 
course), the hi-res mouse interface, and 512K 
RAM. It MUST run on a 4 color, 320 X 192 
screen. If you try to use IE in the 16 color 
mode or in one of the 640 modes, I don't know 
what will happen, but the resulting icon will 
probably bear no resemblance to what you drew 
originally. 



So before you start to type in IE, you 
need an AIF to start up Basic09 on a 320 X 
192, 4 color screen. The following listing 
will do just that. It's an AIF which will 
display the Demo icon above BASIC09. When you 
double click on it, Basic09 will start in the 
correct graphics mode and with more than 
enough memory to use Icon Edit. 

Basic09 

icons /icon. demo 

85 

8 

40 

24 



2 

You can use BUILD or EDIT to create this 
AIF. Once you have IconEdit running, you can 
use it to make new AIFs without having to 
bother with a text editor. 

Save this as "aif.b94", for Basic09, 4 
color mode, or use some other name that will 
tell you what it is later. When you do a dir- 
ectory of this disk with Multi-Vue, just 
click twice on the Demo icon to start 
Basic09. (If you have more than one AIF using 
the Demo icon "^to start Basic09, you won't 
know which one is which, so put this one on a 
seperate disk or seperate directory.) Of 
course before this will work Basic09 has to 
be either loaded into memory already or in 
your current execution directory. 

As was the case with Deluxe PowerGraph, 
you should have Basic09 merged with GFX2 , 
Syscall and Inkey. I described how to do this 
for DPG, so I won't repeat it here. 

IconEdit also requires that ERROR be in 
the execution directory or in memory, and 
that the ERRMSG file be in the SYS directory 
in order to handle the error trapping func- 
tions. 

If you have DPG you can save time by 
re-using some of the procedures from it for 
IE. One of Basic09*s more powerful features 
is the ability to write independent pro- 
cedures which can be used in other programs. 

If you have DPG, load it into Basic09 and 
save the following individual procedures from 
it: 

ReadMouse 
QMouse 
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DuArrow 

YesNo 

Oops 

WnSet 

GetFile 

Convert 

Delay 

After saving these, empty the Basic09 work 
space by typing: kill*. Then load these pro- 
cedures back into Basic09 and type in the 
rest of the procedures. Then save the whole 
thing to disk as IconEdit. 

Using IconEdit is simple. After starting 
Basic09 in the 4 color, 320 X 192 graphics 
mode as described above, and loading Icon 
Edit, start it by typing "run main". The main 
screen will appear almost immediately. 

The large area occupying the left half of 
the screen is the icon editing area. To the 
upper right is a menu with four options: Save 
Icon, Make AIF, Clear Screen and End Program. 
Beneath this menu is a small box which will 
display the icon in actual size. 

The edit area shows the icon at a greatly 
enlarged size to make creating an icon 
easier. The edit area is made up of a box 24 
pixels high and 24 pixels wide. Each "pixel" 
in the edit area is actually an 8 X 8 pixel 
block. 

Drawing an icon is primitive but ef- 
fective. To set a pixel, just put the pointer 
at the correct location in the edit area and 
click Bl . To blank a pixel, put the pointer 
on the pixel, and click Bl again. Since" an 
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Q89 li^T^I a BBS RtbAMJLO 



The b«»at BOS tyBlem hnsjnstirottfin hrtter! System cornea comrlete nn»1 
ready to nm In lesn than 6 minulrs! Use the built in menus or crente 
your own, you cnn even run your own proerams or gnmeti on Une! Complete 
message system allows ensv messo^e posting an'l retrievinp. Complete file 
transfer s>8tefn supports Xmodem and Ymodem as well as keyword srarchJi 
single line and paragraph file desrriptloni^. System runs complefely In the 
background, allowing vou full un« of your comp.itrrf Also come<« wtfh its ow 
Terminal program Quikferm ' Free! 
612k OSS I/evel 1! Required $29 95 

Thh wond'^rful utility allows you to patch anvthing? Patch 

f- M mm^ commands directly on the disk and fit CFlCs automnticallyl 

V^?^\ ^^*". ■""«"«;"'« to patch the nS9boot File without making a 

/X^ \ new boot disk! Save Hies that have been lost or deleted! Fix 

■ J crashed dHks! Hundreds of usesi 

^^^'^ 'Jlk 0S9 !,evel I or 11 required $19.95 

This versaUl*" utility will make your 0S9 life a breeze' j^^^' \ 

S?.!!'"*-!'"l/''!L*""'' *5 Hjpht ,^u,^^ompHcflted direct/)rv r— i J ^ -^ v"^ 





612k 0S9 Level fl Required $29.95 




IdaftLlLlMJi 

Finally 0S9 life becomes easvl With these great ulilifiesyotjll he 
using 0S9 like a pro' Complel«» wild'-ard commands make file 
manlpu at on simple and easy! Tree commands make directory 
m»uiipulatlon a breere? Windowing utilities mnke changing colors 
""?. "^'""JJ ■"" malntnining windows a snap! Matiy other useful 
♦i'J «r !J"? . y*""/ P1^ "^' »"<"^« pleasant? 25 great utilities for onlv 
12flk 0S9 Level II Required $21.95 

FInnlly a complete 0P9 l>evel II windowing terminal that you ran afTord' 
b«J.?7E;rr.' Tu^ ^'^^"''" Include Auto-dlal. A-to macro/File transfers 
bufTer capture, on l(ne fimer. chat mode and much, much morel Menu and - 

WT^k'y^X T^^:^''^'^.''!:'^^^^ compatibility. ^^^ ^ - 

T^J^'t-i RiiiuJifjwi' 

L^HLllf ll J J"""^ "•l^ ^«'"' ^r" P'^P '<'>*n menui wUh this great utility! No 

w .J^_.^wj^ pre»rnmming r,p^ricnre necresnary? With this utilify you ran run any 

^te^^K?^ imf.^r.^rr« ."'A^^^r"* ^".r •* '"*"'*• l^r" ""l'^" !« «opcr simple 

^3r7f^ MuUi ?u V \ "' *"* *^* """"" "" '* develops A m.iM For any 

^ . ^ f^^^ '^'2k os'o u"l II «„d MulUVue required V^^^ 

S«nd Check or money order to: Alpha Soffware Technologies f/r\\ 
or call: (601) 266-2773fl QB HSlW^'buI^',Sl 39402 "0^^?.^' 

Pleof odd $3.00 Shipping on d handling C.O.D. Ofdert add on oddlHonol $2.00 




..$19.95 



icon is only 24 X 24 pixels, elaborate draw- 
ing functions are not necessary. 

As you draw your icon, the image will ap- 
pear at the same time, in actual size, in the 
small box to the right of the editing area so 
you can see what it will actually look like 
when Multi-Vue displays it. 

There are no seperate "modes" in IE. To 
select one of the functions on the menu, just 
point to it and click Bl . You may need to 
hold the button down for a second because 
response time on the menu is slow. The 
function being selected will be highlighted 
as you move the pointer over it. 

Save Icon will save your icon to disk when 
you're done drawing it. When prompted, type 
in the full pathlist for the icon. For ex- 
ample, if you wished to call your icon 
"phone", and wanted to store it in the ICON 
directory which, in turn, is in the CMDS dir- 
ectory, you would enter: 

/dO/cmds/icons/phone <enter> 

If a file by the same name already exists, 
you will be asked if it's alright to re-write 
it. Click on the YES box to go ahead and 
re-write it. Click on the NO box to abort the 
operaton. 

Make AIF will generate an Applications 
Information File for you. All you have to do 
is respond to the questions as indicated 
below: 

Program name: Enter the name of the 
program you want executed. For example, if 
you want this AIF to start up Basic09, you 
would respond by entering BASIC09 or the full 
pathlist of the program. 

Parameters: Some programs may require 
parameters to be entered when the program is 
started up. If this is necessary, enter these 
parameters here. 

Icon file: The pathlist of the icon to be 
displayed for this program. If you wished to 
use the phone icon used in the example above, 
you would enter: "/dO/cmds/icons/phone" . 

Memory: The memory requirements of the 
program. Multi-Vue expects the amount of mem- 
ory to be given in "pages", each 256 bytes 
long. But dealing with "pages" of memory is a 
bit difficult for most people, so IE expects 
you to enter the memory requirements in 
bytes. IE will convert the number of bytes 
into pages for you. 

Screen type: The type of screen display 
required by the program. This is the "format 
code" of the required window as listed in the 
table on page 9-34 of the Basic09 reference 
manual that came with 0S9 L2 . The screen type 
for the 320 X 192, 4 color mode, for example, 
would be 6 . 

Window width: The width of the window in 
characters . 

Window length: The height of the window in 
characters . 
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Background color: The color of the 
background. 

Foreground color: The color you wish the 
foreground (text) to be. 

The other menu functions are: 

Clear Screen: Will erase the screen and 
re-display the menu. 

End Program: Ends the program and returns 
to the Basic09 prompt. 

As usual, IconEdit can be obtained on the 
ClipDisk for this month if you don't want to 
type it in. 

Deluxe Power Graph Note: DPG will not work 
properly if PACKed. The drawing functions 
will work, but the disk I/O functions will 
not. The problem seems to be related to how 
0S9 allocates memory for PACKed Basic09 pro- 
grams. It appears that insufficient memory is 
being allocated to permit the graphics buf- 
fers to be mapped into the user address 
space. But since my schedule is pretty hectic 
at the moment, and since DPG works fine un- 
PACKed, I*m not going to look into the matter 
further at this point in time. If you come up 
with a solution, let me know and I'll print 
it in a future column. 



Questions and comments can be sent to me 
at: 

Randy Krippner 

1014 W. Hwy. 114, Lot 29 

Hilbert, WI . 

Note that the Unicorn BBS is temporarily out 
of service. When it comes back on-line, it 
will be with a new phone number. I'll publish 
it as soon as the board is operational again.; 



More than a year has passed and 
now. . . 

## *s €kminw Bmk- it 

It's Rush Caley & "Downtime! " 

Is Rush the "Morton Downey, Jr." of 
the CoCo World? Read his comments 
on Rapid Fire Topics , R eme dial 
Life, Quotable Quotes, and much 
more. 

Rush is back and with a vengeance. 
Alternating with Down time will be 
a new Q&A co I umn on bus i ness 
applications. Start 1989 with a new 
or renewed subscription to 
Clipboard and Downtime. (Acid 
proof gloves not included) 






Tandy 64K Color 
Computer II 

with Extended Color BASIC 

Only $49.95 

We just purchased 500 units directly 

from Radio Shack. These are new 

units, in original boxes with BASIC 

manual, switch box, and video cable. 

Ideal Christmas gift, backup computer, 
or upgrade from a CoCo 16K machine! 

Add $5.00 for S&H. We will only accept orders that 
can be shipped by UPS to the continental 48 states. 
Discounts are available on large orders. VISA/MC, 
checks, school purchase orders, no CODs. NY resi- 
dents add sales tax. 30 Day money back guarantee. 

Zebra Systems, Inc. 78-06 Jamaica Ave 
Woodhaven, NY U421 (718) 296-2385 
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DOS 



WHY BUY ADOS 
WHEN YOU CAN HAVE 



RAINBOW 

3cfiiriricATiON 
KM. 

THIS 

Mo^: MJt-DOS for COCO 1. 2. and 3 $39.95 

Moit jyoverfuH opetotinc jyitero for the CoCo feTerl 
Allcrt up to 3 DS-80 track drires or standard driTes. The 
D5-80 drirei are roftvare configurable to standard R»4io 

Shack* format in order to maintain compatibility- Allov* 

global file name specification -vith -vrildcards. Ill the filet ▼ill 
be displayed alphabetically, including the date that tha file 
▼ as saTed. Use one command to tILL or COPT a number of 
files that meet the global filename specification (cnn be n 
full diski) in one run or one at a time upon user proapt 
(T-key). Dse the po^erfull CHAIN command to use programs of 
any length. Ose the built in FULL SCREEN EDITOR to ttllov 
fast and easy program modification. Tou can eTen use tbe TKOV 
command that vill put you (after an error) In the mo4ified 
line editor or get the automatic error trap routine vith 
fully spelled out error names, Hit one key to repeat the la«t 
command. You ▼ill also get error trap. repeat key. AOTO. 
DATE, Cat (t^o columns of directory ▼ith only the filenames 
A eKtensiont). VAIT. ROHM. BADD. FIND. OLD. DATES, (strine »» 
basic program), LCOPT (groups of basic lines). REPL (to 
replace a string). TYPE (list a text file on screen/printer). 
SPLIT or JOIN basic lines. SAY for real spoken te«t. ▼ord peek 
ft poke and many more. . Mjt-DOS is primarily intended for 
double-sided BO-track driTcs (7201 each) 

•ALLOVS YOU TO RE A D/V RITE/FORM AT 35/40 DISCS OH A 80T DRIVE* 
«•«•••!« EPROMAELE ••»••* ••»» FREE UPDATES FOR 1 TEAR **** 



$49.95 



MJt5l2 D0S(C0C03-512i:) 

BUILT IN RAH DISK AND RAM TEST COMMANDS 

Monitor-Difosjembler (COCO 1. 24.3) $39.95 

Source-Code Cencrator/LabelCenerotor (COCOl,2ft.3) $49.95 

JB REMOTE rx-232 pack driver for bbs etc (C0C01.2.A3) $19.95 

NEVCEY (C0C03) oe^ key scan--gives you true ALT ft CTRL il5.00 

NEVCET232(COC03)-WB REMOTE and NEVtEY in one package $25.00 

RTC -real time hardware clock for the coco 1.2.&3 $35.00 
CALL OR VRITE (COD ORDERS OK) 

COCO CONlStCTXON or PJCTL^. VA.. 
5003 1\ ST 
VMXLA. VA. 19120 
V'iiOn'E' 215-457-1809 VOXCE Afit^ HXTA 
COHPUStHLXVi: ID- 72317. 437(LE^yi: PKON£«) 
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Product Reviews 



Review Crew 





Dino Data Base 
RAM Electronics 
814 Josephine 
Monmouth, Oregon, 97361 



Pgm. Type J 
Requires : 
Price : 



Educational 

128K Coco 3, disk 

$29.95 



.Pino Data Base is a unique and fascinating 
program. While it is a data base program in 
that it has the ability to retrieve and dis- 
play or print the information contained in 
the data base, that term is somewhat mis- 
leading. This program is more of an infor- 
mation retrieval system, since all of the 
information is already included with the pro- 
gram. The information contained in the data 
base is, of course, about dinosaurs. 

The program permits you to search for a 
particular type of dinosaur by simply typing 
in the name of the dinosaur, or the first few 
letters of the dinosaur's name. (As an alter- 
native, you can move forward or backward 
through the data sequentialy by selecting the 
NEXT or BACK options from a pull down menu. ) 

After the dinosaur has been found, the 
main display screen will appear. This screen 
is split into four windows. The first shows 
the dinosaur's name, the pronunciation of the 
name, the name's Latin meaning, the Order and 
Family, the period of time in which it lived, 
and places where it was discovered. A second 
window displays a list of names of other 
dinosaurs that were related to the one 
selected. The third window displays a drawing 
of the dinosaur itself. The fourth window 
displays a world map, with indicators showing 
where the fossil remains of the dinosaur were 
found. 

After the dinosaur is displayed, the menu 
will pop up, permitting you to move backwards 
or forwards through the file to view infor- 
mation about other dinosaurs, perform another 
search, end the program, or jump into another 
mode which permits the information about a 
dinosaur to be printed out on a printer* 

The information about each dinosaur is 
limited, of course. It would be impossible to 
put everything known about these fascinating 
creatures into a single data file. But it is 
still quite interesting to flip through the 
data base, getting an idea of 
animals looked like, where they 
etc . 

This program is probably best 
42 



what these 
were found, 

suited for 



grade school aged children, who seem ab- 
solutely fascinated by it. They would flip 
through the various dinosaurs that appear in 
the data base and use the search functions to 
find particular dinosaurs they were inter- 
ested in. 

Dino Data Base is a very well crafted 
program. The only problem I had with it was a 
very minor one; there is no option to change 
the printer baud rate within the program. If 
you wish to use a baud rate other than the 
default of 600, you will have to poke the 
appropriate value in before running the 
program. 

The Memory Game 
RAM Electronics 
814 Josephine 
Monmouth, Oregon, 97361 

Pgm. Type: Game 

Requires : 128K Coco 3, disk, joystick 

Price : $19.95 

The Memory Game is a matching game similar 
to the old Concentration television show. 
Pairs of cards are placed at random, face 
down on the screen. The player uses the joy- 
stick to select two cards. These cards are 
turned over, displaying the symbol on the 
cards. If the symbols match the player gets 
credit for the match and may continue. If the 
cards do not match they are turned back over 
and the player has to try to make anotlier 
match . 

Up to four people may play the game, 
taking turns at attempting to find matches. 
If more than one person plays, the winner is 
determined by who makes the most matches. If 
one person plays, the player works against a 
timer. 

Operation of the program is simple. Except 
when entering in the names of the players, 
the game is operated entirely by the joy- 
stick. The author ought to be congratulated 
on the excellent use of the Coco 3's 16 color 
hi-res graphics. The display is colorful, 
attractive and very well designed. 

While the concept behind the game is 
simple enough so that even a pre-school age 
child can understand it and enjoy it, it is 
also challenging enough for adults. (My five 
year old son^ beats me with embarrassing reg- 
ularity. ) 



' ♦yes ) 



0179 10 
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0206 
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0220 
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0242 

024B 

0257 

025B 

025F 

0263 

0265 

0267 

0271 
PROCEDURE 

0000 

0025 

002E 

0039 

0040 

004C 

005D 

006A 

006C 

006E 

0074 10 

0083 

OOAO 

00B7 

OOCE 

OODC 

00E8 

00F6 

OlOD 

0124 

0132 

0138 

014D 

0163 

0165 100 

016E 

017A 

0190 

0199 

01A5 

01A9 

OlAD 

OlAF 

OlBl 

01B3 

OIBD 
PROCEDURE 

0000 

0007 

0019 

0024 END 
PROCEDURE kbuff 

0000 RUN j?fx2( "killbuff'M9,l) 



CREATE #path,aif: WRITE 
PRINT #path,pgin 
PRINT #path,prnis 
PRINT #path,icon 
PRINT tpath.mem 
PRINT #path, screen 
PRINT #path,col 
PRINT #path,row 
PRINT #path,bckgnd 
PRINT #path,frgnd 
CLOSE #path 
RUN gfx2( "owend" ) 
RUN gfx2C'curoff" ) 
SHELL "tmode -echo" 
END 

enum=ERR 
IF enuni=218 THEN 

RUN yesno( "Re-Write? 

IF yes THEN 

SHELL "del "+aif 
GOTO 10 

ELSE 

GOTO 20 

ENDIF 
ENDIF 

RUN oops(enum) 
GOTO 20 
Svlcon 
TYPE registers=cc,a,b,dp:ByTE; x , y, u : INTEGER 
DIM regs: registers 
DIM enum, path: INTEGER 
DIM yes: BOOLEAN 
DIM filename: STRING! 30 J 
RUN getfiJe( "Name" , filename ) 
IF LEN( filename )<2 THEN 

END 
ENDIF 

ON ERROR GOTO 100 
CREATE #path, filename: WRITE 
RUN gfx2( "get ",19, 1,248, 103, 23, 24) 
regs.a=l \regs.b=$84 
regs.x=$l301 \regs.y=l 

RUN syscalK $8E,regs) 

regs.a=path 

RUN syscall($8A,regs ) 

regs,a=l \regs.b=$84 

regs.x=$1301 \regs.y=0 

RUN syscall ( $8E,regs ) 

CLOSE #path 

SHELL "attr "+filename+" c pe" 

RUN gfx2( "killbuff",19,l ) 

END 

enum=ERR 

IF enum=218 THEN 

RUN yesno( "Re-Write?" , yes ) 

IF yes THEN 

SHELL "del "-f filename 
GOTO 10 

ELSE 
END 

ENDIF 
ENDIF 

RUN oops (enum) 
END 
delay 
DIM x:REAL 
FOR x=l TO 70 
NEXT X 



Game 



an 



excellent 



The Memory 
alternative to the mindless shoot- 'em-ups 
that dominate the computer game market. The 
graphics are excellent, it's easy to play, 
but not easy to win. This is one of the few 
games on the market that the whole family 
will find entertaining. Highly recommended. 



FKEYS III 

Gimmesoft 

P.O Box 421 

Perry Hall, MD 21236 

Pgm. Type: Function key utility 
Requires : 64K Coco I/II/III, 1 drive 
Price : $19.95 

1 do a lot of work with my Coco. I'm at 
the keyboard fof at least four or five hours 
a day or more, so I am constantly looking for 
software to make life with a computer a 
little easier. FKEYS III has proven itself to 
be one of the best function key utilities 
I've seen. 

The basic idea behind function keys is 
this: Instead of having to type in a long 
string of characters to make the computer 
perform a task, function keys let you do the 
same task by simply pressing one or two keys 
instead of ten or twenty. Instead of typing 
something like "CLS:DIRO: ?FREE( ) <ENTER>" 
all I have to do with FKEYS III loaded is 
press Fl on my Coco 3 keyboard. 

FKEYS III comes with twenty predefined 
functions that can be activated by simply 
holding down the CTRL key, then pressing the 
function key. (The down arrow key is used as 
a control key on keyboards that lack the 
extra k^ys of the Coco 3 keyboard. ) 

Any of these functions can be easily 
redefined to fit your own needs. Just about 
any RS-DOS or Extended Color BASIC command 
can be programmed into a function key. The 
"only restriction is that the function can 
only be up to 25 characters in length, which 
should be sufficient for almost any appli- 
cation. 

FKEYS III can make life much, much easier. 
You can load and run programs, call up disk 
directories, do POKEs or perform any function 
you would normally type in, just by pressing 
a function key. 

And, of course, FKEYS III lets you save 
your redefined function keys to disk so you 
don't have tp reprogram them every time you 
want to use the utility. 

If this was all FKEYS III did, it would 
still be a very useful program. But there's 
much more. 

FKEYS III lets you modify your DOS to 
handle 35 or 40 track disk drives , single or 
double sided drives, and can even change the 
step rates to increase the speed of the 
drive. It also resets the drive head to track 
to prevent the annoying head banging prob- 
lem that occasionally occurs if the drive 
head is in the wrong place when the drive is 
turned on. 

There is even an option to save the 
modified DOS to a disk file which can then be 
used to burn an EPROM which can be used to 
replace the DOS ROM chip in your disk drive 
controller so that the FKEYS III functions 
you've defined can be available as soon as 
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I Just got home from the RainbowFest in 
Princeton where Ted reminded me that I am due 
for another column. Time sure flies! 

Many of you that read this column know 
that I have been working on a program called 
Wiz Professional. Well, I did release it at 
the 'Fest as promised, but not as a com- 
mercial product. I decided to go shareware 
instead. The package is already available on 
all of the services and many BBS's. If you 
cannot download it for whatever reason, I 
will put the same package on a disk that you 
send me & return that disk to you. If you 
wish the entire package, see the shareware 
notice below. 

***********♦******♦******:»:**♦*************♦** 

Wiz Professional Sharware Information 

Wiz Professional is copyrighted 1988 by 
William L. Brady. 

OS-9 owners who wish to support the 
development of Wiz Pro and extensions are 
asked to make donations to: William L. Brady, 
1503-1 Flanders Lane, Harwood MD 20776. Do- 
nations received in excess of $39.95* will 
receive the 50-f- page laser printed manual, 
which includes margin notes and many illus- 
trations, plus the unabridged version disks 
which include WizClipper and WizAuto XPROCS , 
and other extensions/updates, autolog file 
examples and source codes. 

To become fully registered as a Wiz Pro 
user, include the following information: 
First name, ^Last name, street #, street name, 
city, state/province, code, country, CIS PIN, 
Delphi and Genie address. 

*Wiz users making a donation in excess of 
$19.99 will receive the same package on re- 
ceipt of a COPY of the WIZ coupon, plus a 
copy of their sales receipt. See the Wiz 
manual, do NOT send to FHL. 

Those wishing to become Wiz Pro developers 
will receive additional resources and direct 
support. A donation of $25.00 is requested to 
cover the extra expenses. 

Please to not send electronic mail to the 
author on CIS. Mail is OK on Delphi, 
(0S9UGED), or GEnie, (B.BRADY), or in the CIS 
OS-9 forum message base. (Bill Brady 70126, 
267). 

Should I use this program? 
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Wiz Pro is a very powerful program. It 
gets its power from Basic09 and OS-9 Level 2. 
To do this, it must be fully integrated into 
the system. There are two reasons why this is 
important to you. First, you will have to 
make a new boot. Tandy & Microware do not 
allow third party s/w writers to provide 
bootable OS-9 software for the Color Com- 
puter. Making a new boot can be tough, but 
once you master it, you are in control of 
your own computer. You are the "system man- 
ager." The second factor is that you may need 
to "clean-up" your system. If you have in- 
stalled patches to system modules, you may 
find that they interfere with the interrupts 
that are vital for the RS-232 pak to func- 
tion. You will need to remove them. 

All of the above assumes that you already 
know about Wiz Pro, but in case you have 
never heard about it, it is a terminal pro- 
gram that many consider among the best for 
any computer. 

Someone recently referred to me as a third 
rate programmer. The truth is that I am not a 
programmer at all. In that regard I am at 
least 4th or 5th rate (grin). But having been 
a hardware type back when hardware was 
expensive and software was cheap, I learned a 
few important things. Foremost is that I 
learned how to find "boundaries." 

The first of these boundaries is the one 
between the ^ hardware and the software. To 
explain why this is so important, I need to 
use an example, which I will do a little 
later. First a short course in systems en- 
gineering. 

This may seem simple, but the first step 
in deciding on exactly what you want to do 
with the computer. For example, you want to 
write a letter. You begin to build a list of 
requirements. One way is to ask questions 
like: Does the letter have to be stored in 
the computer? Is hardcopy required? How big 
is the letter? Is the letter to contain text 
only, or text and pictures? Is it necessary 
to edit the letter? 

From this list you can select items and 
allocate them to resources that are avail- 
able. Storing the letter might be allocated 
to a disk drive, printing to a printer etc. 
As you go along, other requirements build: a 
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Modular Programming 



Boisy Pitre 




Greetings again! I trust you have been 
practicing some modular design techniques in 
your work. Things have been rolling and chug- 
a-lugging here in Brookhaven, Mississippi. As 
I write this, Hurricane Gilbert, as most of 
you have heard about, may be planning a visit 
to our gulf coast in a day or two. Actually, 
I have been relatively busy squeezing in Disk 
BASIC programming time between college alge- 
bra, trigonometry, and OS-9 Level II. Don't 
worry fellow Disk BASIC comrades, I haven't 
been completely converted to OS-9. I'm just 
dabbling into the fundamentals, but that's 
another story. 

Last issue we went over modular design 
programming, and some of the events that 
occur when we neglect to use it. After mas- 
tering the BASIC language, we have a tendency 
to neglect those important aspects of pro- 
gramming we so precariously noted when we 
first learned BASIC. 

Looking back on my first experiences with 
the CoCo , I can see how my attitude towards 
preciseness had diminished. Most of the time 
I had spent planning a simple program was 
neglected when the biggies came. That's the 
time I really should have been attentive! 
After viewing and studying listings from 
other languages like C and BASIC09, I real- 
ized that there was a better way. With eager- 
ness, I purchased a book on structured 
programming for the IBM. Since GW-BASIC and 
CoCo BASIC are basically (no pun intended) 
the same, there were few conflicts with pro- 
gram listings and no conflicts with modular 
concept . 

After studying the book, I realized that 
complex BASIC programs COULD be done in a 
truly structured manner. The most dreadful 
times I faced was when my ideas failed to 
come about because of complexity in struc- 
ture. Instead, the confusion of keeping up 
with variables, GOSUBs , and GOTOs were just 
too burdensome. Modular programming showed me 
a better way. And it can help you too. 
Programming takes as much concentration as it 
does skill. One can be fluent in BASIC as 
comparable to an American to English, but 
enough ?SN ERRORS and ?FC ERRORS can bring 
frustration to the programmer. Although some 
make it through, most reach behind the CoCo 
for the power-switch and push it in, putting 
the idea out of their head. 

This is where modular design steps in. 
Some of you may have played out the same sce- 



nario as the one above. However, programming 
doesn't have to be a sweat-it-out, mind- 
boggling experience. 

In this issue we will be concentrating on 
the last two program modules: SUBROUTINES and 
ERROR TRAPPING. I'll also be giving a few 
hii\ts and then finally sum up modular 
programming and announce the "winning idea." 
For those of you who are just arriving on the 
scene, I suggest that you order back issue #7 
for the beginning article on modular pro- 
gramming. 

Ok! Load the MODTUTOR program you typed in 
last issue. Verify that it is in memory with 
a LIST or RUN, then type in Listing 1. Don't 
worry about it conflicting with your program 
in memory -- the line numbers will neatly fit 
in place, that is if you haven't RENUMbered 
your listing from last month. After you have 
typed and debugged, SAVE your program under 
the same name ( MODTUTOR . BAS ) . You now have 
the complete Modular Design Tutor program 
available along with a fix for a bug found in 
the listing last issue. Bear in mind that the 
purpose for this program was not just to give 
you something to type. Use it as an outline 
for your future modular programming projects. 

THE ERROR TRAP MODULE — LINES 40000-49999 

This module is debatable. Since the advent 
of the CoCo 3, error trapping has become a 
iuxury. On the older CoCo 1 and the CoCo 2 
however, error trapping is considerably 
harder to implement and manage. I'll go over 
both the CoCo and the CoCo 3 techniques of 
error handling. 

CoCo 3 programmers have the luxury of ON 
ERR GOTO. Somewhere in your MAIN PROGRAM 
module, set up the line specified by the ON 
ERR GOTO command in the INITIALIZATION 
module, which follows this format: EL=ERLIN: 
ER=ERRNO:GOTO 40000. This way, EL holds the 
error line and ER holds the error number. Use 
every two lines, like 40000-40001, 40002- 
40003, to check the error number and take the 
needed action, proceeding each with a GOTO 
EL, or whatever line number you wish. It is 
also a good idea to comment on each error 
condition and action with a REMARK. 

CoCo 2 programmers don't have it as easy. 
There are some commercial programs which give 
CoCo 1 & 2 users an ON ERR GOTO command, but 
programs of that nature are not owned by all. 
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VIDEO ENTERTAINMENT 



the computer is turned on. (It's up to you to 
burn the EPROM yourself or find someone to do 
it for you . ) 

FKEYS III is a very useful utility, and 
one which I have enjoyed using a great deal. 



I do, however, have a few tips for those of 
you who have no type of error handling 
management at all. 

One error we will play is the ?NE ERROR, 
or Non-Existent file. This error occurs 
mostly when, let's say for instance, one 
program calls another program or data file on 
the, disk. Use this short program to take care 
of this error: 

1000 OPEN"D" ,#1 , •• SOMEFILE.DAT" 

1001 IF EOF(1)=0 THEN PRINT "FILE DOESN'T 
EXIST!": END 

1002 CLOSE #1 'Continue from here... 



DIIvlO PICIIJRE DATA BASE- 194 Dinosaurs 1 Nanius, areas, 
latin meanings, time periods, pull down menu, world map 
on screen. Powerful, cx)lorful, educational. 0CXJ03 19.95 
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Build your own coin-operated Video Game using the COOOl 
Complete instruction book with plans, schematics, parts 
sources. All software provided and includes a 4 in 1 
video gane that you can use. CDOO 1 and 2. Disk 19.95 



Autc±oot your computer- This harcir^are project will 
RUN a program as soon as the COCO is turned on, 
without you having to touch tl^ie keyboard 1 Scheanatics 
and instructions only 9.95 OOCOl and 2. Will work 
on most switch matrix type computers. 
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FRAZE CRAZE- Wlieel a fortune witli this popular word 
game. COCO 1,2 64K or C0003. 9.95 DISK /^^Ji 



•niE MEMC«Y GAME-Flip a card and see if you can find its match. With basic 
shapes for younger players, all the way up to intricate shapes for those 
with OONCQ/TRATING minds. A beautiful family game I 00003, Joystick, Disk 9.95 



Why go to REWO? Now you can enjoy tlie excitement of a Casino style 
game with BIG CITY KQOl Be a big winner on the 00003, Disk, 9.95 



CHECK, MONEY ORDER OR C.O.D. IN U.S. tDNDS TO RAM ELECfHONlCS 
814 JOSEPHINE, MONMOUTO, OREGON PHONE NUMBER 503-838-0139 




Your PTaonal Electronic Photo Albuip 

Put you, your spouse, your kids, your Grandma, your 
dog, or anything elsa you like on your vary own 
personal picture disk I You send us your pictures or 
artwork and we will digitize it and save it on disk 
for you, in one of the foraats below. Originals can 
be as saall as a staap or as large as a poster. All 
originals returned. 

The cost is $13.99 for the first disk and $10.00 for 
each additional disk, ordered at the saae time. Each 
disk can contain ONE of the following: 

8 MGE foraat files (for Coloraax3) or 
10 CMS foraat files (for CoCoMaxB) or 
15 PMOOE format files (for CoCoHaxII, MCPAINT, etc.) 

Pictures should be fairly high contrast or the results 
can be disappointing. Be SPECIFIC about the roughly 
square area you want digitized. 

Those ordering MGE or CMS format pictures for their 
CoCoS will also receive the incredible viewer program, 
VUHASTER, absolutely FREE! CoCoi,2 or 3 owners can 
cut out or copy this ad, send it in with your order 
and get the $iO PMODE viewer /manipulator, Graf Find for 
only $51 (Reviewed in Apr '88 Rainbow and Jul /Aug '88 
CoCo CI ipboard> 

For a FREE sample disk, please send $3.00 S/H, along 
with your model CoCo and the format you wish. Call or 
write if you have questions or need additional 
details. 



Add $3 S/H per order. 
Payment may be personal 
check or Money Order 
only. Sorry, no cash, 
credit cards or COD' a. 



10625 SE 362nd B32 
Boring, OR 97009 

CS03I669-2429 (9a«-9pai PSTl 



The routine above opened a file called 
SOMEFILE.DAT. Since this was a random access 
file, it wouldn't have given an ?NE ERROR if 
the file didn't exist. Instead, it went ahead 
and created the file, though empty, and 
checked to see the EOF flag. If EOF was 0, we 
automatically knew that the file was empty, 
therefore never existing in the first place. 
Of course, you would need to KILL the empty 
SOMEFILE.DAT file because it was created by 
OPENED" . 

?SN ERROR is an error that should be 
encountered with only when developing and 
testing the program, not at user RUN-time. 
With experimentation, try finding other ways 
to circumvent errors. For instance, to pre- 
vent a ?DF ERROR^ (Disk Full), use the 
D=FREE(0) function. If D=68 or the number of 
tptal granules that your disk can hold, then 
print a DISK FULL message. 

THE SUBROUTINE MODULE -- LINES 50000-59999 

The SUBROUTINE module contains subroutines 
for the program. Commonly used routines, such 
as PRESS A KEY prompts and INPUT commands can 
be inserted here. I've always believed that 
it was better to use GOSUBs instead of the 
same commands over and over again. The SUB 
ROUTINE module benefits the progframmer by 
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conserving memory that would otherwise be 
used by repetitive commands. It also cuts 
down considerably on typing. 

The SUBROUTINE module should be broken 
down into separate subroutine fields seper- 
ated by REM statements. Each REM statement 
should fully comment the subroutine. I re- 
commend keeping a subroutine library in ASCII 
format with a line number range of 50000- 
59999. When you need your library, just MERGE 
it to- the program you are working on. Presto! 
Instant magic! 

SUMMING IT UP 

Modular programming is advantageous. It's 
design and concept is easy to grasp and well 
organized. Maybe there are some of those who 
are set in their ways about their own style, 
but for beginning programmers and those want- 
ing to get into serious Disk BASIC pro- 
gramming, it will save you many wasteful 
hours. Keep in mind the basic module 
structure of top-down design. Feel free to 
experiment with your own preferences. Be 
innovative! You may be able to program better 
with another style that the one we have been 
practicing with. All in all, implement, 
implement, implement! Use it every chance you 
get! Learn it to the bone and without a 
doubt, you will see your ideas come to life! 



' THE INITIALIZ 
MAKES UP THE FI 
YOUR PROGRAM. 
PART OF YOUR PR 
SUCH AS pclear, 
SHOULD BE USED 



1040 PRINT:PRINT' 
AT ION MODULE IS 
HST 100 LINES OF 
IT IS THE SET-UP 
OGRAM . COMMANDS 

clear, AND dim 
HERE.": PRINT 

1041 PRINT " YOU MAY ALSO DEFI 
NE NUMERIC AND STRING DATA HERE 

USE YOUR 'ONLY-ONCE' COMMANDS 
HERE." 
1999 GOSUB40001:GOTO 250 
ii999 GOSUB40001:GOTO 250 
3000 '*** CHOICE 3 *** ' 
3010 CLS 

3020 PRINT" PART THREE-ERROR T 
RAPPING 
3030 PRINT" 
49999" 
3040 PRINT 
3050 PRINT" 
MODULE IS 
CTOR . ON 
N ERR GOTO 
ERRNO &. 



LINE RANGE: 40000- 



THE ERROR TRAPPING 
USED AS AN ERROR DIRE 
THE COCO 3 WITH THE O 
COMMAND, YOU CAN USE 
ERLIN WITH CONDITIONA 
L OPERATORSTO TAKE CARE OF ERROR 
S EASILY.": PRINT 

3060 PRINT" COCO 2 OWNERS SHOUL 
D CONSIDER PURCHASING ERROR HAND 
LING UTILITIES OR OTHER AL 

TERNATIVES." 



GOSUB40001:GOTO 250 
GOSUB40001:GOTO 250 
'*** CHOICE 4 ***' 
CLS 



3070 
3999 
4000 
4010 
4020 PRINT" 
TINES 

4030 PRINT" 
59999" 
4040 PRINT 
4050 PRINT" 
LE HOLDS 
D CODE & 
OGRAM . 
OMMENT 
NT 

4060 PRINT 
E YOURSELF 
WITH YOUR 
UBROUTINES. 
D MERGE IT 
RE WORKING 
4070 
4999 



PART FOUR-SUBROU 
LINE RANGE: 50000- 



THE SUBROUTINE MODU 
THE MOST COMMONLY USE 
STATEMENTS IN YOUR PR 
FOR EASY REFERENCE, C 
EACH SUBROUTINE . " : PRI 

" BETTER YET, COMPIL 
A SUBROUTINE LIBRARY 
MOST COMMONLY USED S 
SAVE IT IN ASCII, AN 
TO THE PROGRAM YOU A 
ON." 

G0SUB4 0001: GOTO 250 

GOSUB40001:GOTO 250 



5999 GOSUB40001:GOTO 250 

40000 '**»** SUBROUTINES ***** 

40001 'PRESS A KEY PROMPT 

40002 PRINT@490, "PRESS A KEY:" 
EXEC34442: RETURN 



VIP Calc 

"MORE USEABLE FEATURES" 

FEBRUARY 1985 "RAINBOW" ^ , 

, Now every CoCo owner has access to a calculating and planning 
tool better than V'lsiCaic'^, conteuning all its features and 
commands and then some. VIP Calc displays 32 51, 64 or 85 
characters by 21 or 24 fines right on the screen. VIP Calc allows up 
to a 33K worksheet with up to 512 columns by 1024 rowsl In 
addition. VIP calc has multipte windows which allow you to 

' compare and contrast results of changes. Other features include 
16 DIGIT PRECISION • trig, functions • averagirig • ataebrac 
functions • column and row ascending or descending SORTS • 
locate Ibnnulas or tittes in cells • block move and replicate • gtobal 

I or local column width • limitless programmable functk)ns • wpite 
with any printer, Embed printer control codes for customized 

' printing. CombinespreadsheettaWeswith VIP Writerdocumentsto 
create ledgers, prc^k>ns, statistk»l and financial budgete and 

' reports. Requires 64K. D»S 



VIP Speller 1.1 

INCLUDES 50,000 WORD DICTIONARY 

VIP Speller works with ANY ASCII file created by 
most popular word processors - even Telewriter 64. 
It automatically checks text files for words to be 
corrected, marked for special attenfion or even 
added to the 50,000 word Dfefionary. You can even 
vtew the word in context Wbrdscan be added to or 
deleted from the dictionary or you can create your 
own dictk)naryl New features of verston 1.1 are 
FASTER and more RELIABLE disk access and 
printing at 9600 BAUD. DISK $34.95 
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"EZWRITER" does professional-quality letters { 
quickly and easily. "EZWRITER" 
tically set the margins & characters per line, j 
indent paragraphs, put your headipg/greeting/ j 
closing in the right places, and even center the j 
letter on the page! Just type your message and ^ 
vyatch your DWP or EMP print a perfect letter! ! ! I 
Handles 1-4 pag^ letters, mailing lists, and r 
labels. It will make it possible for you to ^ 
J, send any nunber of copies with a salutation for i 
i\ each recipient!! Perfect for personal corre- j 
j spondence, for letters to club members, or for j 
i direct mail advertising. ''EZWIUTER" is by far j 
\ our #1 Best Seller, and it's no wonder; it's the j 
absolutely siiiq)lest letter writing system avail- j : 
\ able for the CoCo! StLLL only $19.95 plus $1.50 
S/H for either disk or cassette. 

\ CoCo 3 but will run on any CoCo with 32k EGB 
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E.Z. FRIENDLY SOFTWARE 

118 CORLIES AVE. • POUGHKEEPSIE. NY 12601 • (914) 485-8150 
(Add $1.50 s/h to all orders. NY residents add state sales tax.) 
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capability of opening, reading, modifying 
disk files is needed, so we allocate that to 
the software. When you store files on a disk, 
they must be named. . . you allocate that to 
the operator (perhaps). The files should also 
be organized in some way so they are easy to 
find., you allocate that to ... software? the 
operator? the operating system?? Beginning to 
get the idea? 

Now for the importance of this process of 
allocation. Back in the 70 *s computer 
hardware was not as smart as it is today. The 
math capabilities were often limited to add, 
shift, AND, OR, and complement. You sub- 
tracted by doing a complement, then an add. 
Multiply was done by shifting. About this 
time I worked a project where there was a 
real need for the capability for high pre- 
cision (floating point) math. The capability 
did not exist. Since the person in charge was 
a programmer, this requirement was allocated 
to s/w. A number of programmers started work. 

A great deal of time and money were used 
in this effort. A deadline loomed. The 
floating point software package still did not 
work, it was very slow, it used up a great 
deal of hardware resources. Perhaps another 
computer would be required. Enter the 
hardware types. 

We found a black box called a floating 
point processor. It cost $5000, less than 
l/50th of what had already been spent on the 
s/w effort. It was lightning fast, and used 
almost none of the main processors time since 



it ran in parallel. It had one other advan- 
tage: it worked. 

So you can see that finding that hardware 
/ software boundary was very important. If it 
had been done sooner it would have saved many 
dollars, later would have meant the failure 
of the project. 

These boundaries exist, and must be 
identified at many levels. There are bound- 
aries between h/w and s/w, between h/w and 
operations, between s/w and operations, and 
between s/w and s/w. Software boundaries in- 
clude those between the operating system and 
the application, between an application and a 
device driver and between the operating sys- 
tem and a device driver. 

Boundaries shift. What causes these 
shifts? Time, money, the operator, and the 
building of the resource pool in both s/w and 
h/w. In what directions do we want the shifts 
to go? Less time, both to develope, and to 
use, and less money of course. But the never 
varying final goal is to shift the boundary 
AWAY FROM OPERATIONS! 

How does all of this apply to Basic09? Re- 
member that my goal in this column is not 
just to tell you how to do something, any 
programmer can do that, but to tell you the 
why and when. Why use Syscall? When? Why use 
Basic09? When? Let us begin to take a look at 
the boundary between a piece of hardware, a 
modem, and a piece of software, a terminal 
program. 



FILE TRANSFER LmUTIES 

You asked for it at the Chicago RainbowFeet - 

RLE TRAMSFER imtmES NOW HANDLE RSDOS WSKSI 

Need to transfer text fles to and from PC (MSOOS). RSDOS and FLEX disks into 
your CoCo (OS-9) system? Have text flee on a PC (MSDOS ) system at work and 
want to work on them at home on your CoCo? 

WRh GCS RIe Transfer Uillties you just place the PC (MSDOS). RSDOS or FLEX 
disk into your CoCo disk drive • enter a simple command and the fite is copied into 
a CoCo OS-9 file. File transfer back to PC (MSOOS). RSDOS and FLEX disks is 
just as simple. 



PCDR dinectoryofPCdisk RSDIR 

PCDUMP display PC disk sector RSDUMP 

PCREAO read PC file RSREAO 

PCWRfTE write file to PC disk RSWRITE 



directory of RSDOS disk 
display RSDOS disk sector 
read file from RSDOS disk 
write file to RSDOS disk 



FORENAME rename PC file 
PCDELETE delete PC file 
PCFORMAT fomrial PC disk 



FLEXDIR directory of FLEX disk 

FLEXDUMP display FLEX disk sector 

FLEXREAD read FLEX file 

FLEXWRfTE wrtte fite to FLEX disk 



Extensive Single, double sided disks. 40 or 80 track fk)ppy drives. 

Options 8 or 9 sectors. First level sub<iirectories - PC (MSDOS). 

FLEX transfers binary files also. 

Requlns OS-9 (Level 2 for MultiVue). 2 drives (one can be hard). MultiVue 

for MultiVue version. SDISK (SDISK3 for MultiVue) - see D.P. 
Johnson ad for SDISK 

GSC RIe Transfer Utilities for CoCo - MultiVue version $54.95 

GSC File Transfer Utilities for CoCo • Standard version $44.95 

All diskettes are CoCo OS-9 format. Orders must be prepaid or COD. VISA/MC 
accepted, add $1.50 S&H. additbnal charge tor COD. 
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GRANITE COMPm-ER SYSTEMS 

Route 2 Box 445 Hillsboro. N.H. 03244 RAINBOW 

(603) 464-3850 certification 

SEAL 

OS-9 is a r«<JemarK of Micro*wf» Sysiwrw Corporation and MotoroJa Inc. 
MS-DOS is a tradamark of fcfcaosofl Corp. FLEX is a fradamark of TSC. Inc. 
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just to work at 
The bottom line 
thing else while 



Data comes out of a modem serially, that 
is one bit at a time. The computer stores 
data in parallel, 8 bits per word. If we are 
to move data out of the modem and into the 
computer, a serial to parallel conversion 
must take place. In the Color Computer we 
have a harware device called a PIA. Without 
going into great detail I will just say that 
the PIA can be made to read one bit at a 
time. With software we can convert 8 bits to 
one word, but it is not that simple. You must 
know which 8 bits to put into any particular 
word - it's called synchronization. All of 
this can be done. Many fine terminal programs 
exist which do this technique called "bit 
banging." The problem is that this process 
takes every bit of the hardware's resources, 

relatively low baud rates, 
is ' that you cannot do any- 
the conversion is going on 
and even then it is slow at it's max speed. 

Remember the floating point hardware? Well 
there is "serial-to-parallel" hardware also. 
One of these devices is called an Asyn- 
chronous Communications Interface Adapter or 
ACIA for short. Just like the floating point 
h/w, the ACIA is much faster, and takes no 
resources and does both the serial to par- 
allel conversion and the synchronization. 
Unfortunatley, Tandy did not build an ACIA 
into the Color Computer. 

So, if we are writing a terminal program 
for the CoCo, we must decide whether to allo- 
cate the s/p conversion and synchronization 
capabilities to h/w (an RS-232 Pak ) or to the 
s/w (a "bit banger".) Not all users own an 
RS-232 pak. 

Under OS-9 our decision is a little 
easier. OS-9 is mulit-tasking and on the CoCo 
we have windows. These two capabilities of 
the operating system allow us to clear-key to 
another window and run some other program at 
the same time as our terminal program. Those 
of you who use this capability know that this 
is no trivial nicety, but is what makes the 
CoCo such a powerful computer today. Why 
throw this away? Why not xmodem a file in one 
window and de-archive it on the fly in 
another? 

To use the bit-banger port would negate 
all of this. So we allocate the capability to 
h/w and require an RS-232 pak. This still 
doesn't solve the problem however, and we can 
still blow our multi-tasking capability even 
with an RS-232 pak. How? By placing yet other 
boundary in the wrong place? Next time we 
will see just how fine this line must be cut, 
and look at some code. 

Before leaving you, however, I promised to 
show you how to capture a mouse "key down" 
event within a BasicOQ procedure. With Wiz 
Pro, any time you are on line you can pause 
both Wiz and the host by simply tapping the 
mouse key. This allows you to stop some- 
thing from scrolling off of your screen 
before you've had a chance to read it. For 
this to happen, and to really be useful, 
everything must come to a halt very quickly. 
I choose to use the SS.MsSig system call. 

The SS.MsSig call tells OS-9 to send you a 
signal when the mouse button is pressed. The 



call also allows you to specify a signal # 
for the call to return. See page 8-141 in the 
Level 2 manual . 

First lets set the signal: 

s.a=0\ s.b=$8A\ s.x=140 
RUN syscall( ststat , s ) 

Now something to "catch" the signal: 

( t ♦♦♦♦♦♦♦ ♦♦♦:|e]|ett4c3|::|c:|e:tc:|c:|c3|e 

ON ERROR GOTO 100 

Now something to process the signal: 

100 en=ERR 

IF en=141 then 

(♦ send x-off , go to sleep etc 

When we are we don't want to leave the signal 
active so we disable: 

s.a=0\ s.b=:$lB \ s.x=140 
RUN syscall( ststat , s ) 

See you the next time! -Bill Brady 



VIP Terminal 

RATED BEST IN JANUARY 
1984 "RAINBOW" 

For your important communications needs 
youVe got to go beyond software that only 
lets you chat. You need a smart terminal 
so that you can send and receive 
programs and messages and print them! 
The VIP Terminal features 32, 51 . 64 or 85 
characters by 21 or 24 lines on the screen 
and has a 43K byte buffer to store 
information. DISK $29.95 



VIP Disk-ZAP 1.1 

RAVED ABOUT IN THE 
APRIL 1983 "RAINBOW" 

Now you can retrieve lost data on any disk. VIP 
Disk-Zap is the ultimate repair utility for repair of 
most disk errors. VIP Disk-Zap verifies diskettes, 
reads and writes any sector and lets you retrieve all 
types of bashed text files, BASIC and ML programs. 
VIP Disk-Zap includes an informative 50 page tutorial 
manual. New features of verston 1.1 are FASTER 
and more RELIABLE disk access and printing at up 
to 9600 BAUD. DISK $24.95 



VIP Disk-Zap owners: upgrade to VIP Disk-Zap 1.1 for 
$5 + $3 S/H. Send only ORIGINAL disk and $8 Total. 
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I was dumbfounded when Ted asked me to do 
an article about this subject. I've been rel- 
atively well known in the CoCo market for a 
number of years - at least in the business 
applications portion of it. But one thing not 
many people know about me is my passion for 
the Model 100 laptop computer. It is not as 
though I have to keep it sequestered away 
somewhere so no one will notice it; but I 
don't talk about it too much. There's a cer- 
tain "cloak of loyalty" that has to be worn 
and recognized when facing CoCo fanatics. 
It's funny, I use my Model 100 almost as much 
as I do the CoCo. And for all these years, I 
still feel like a philandering husband 
cheating on his faithful wife. 

Anyone who has used a laptop for any 
length of time will realize that how you sup- 
port the laptop is wholly defined by your 
specific "workstyle" and the particular tasks 
you need to accomplish. The purpose of this 
article is to mention some of the more useful 
things that one can do by interfacing the 
Model 100 with our beloved CoCo. 

When it was originally released, the M-lOO 
arrived "out of the box" with 24K RAM and 
sported an 80C85 8 bit microprocessor that 
ran at 2.4 MHZ. The LCD screen was 40 X 8 
lines. It also came loaded with ROM software 
or "built-in" applications programs. It had 
BASIC (one better than the CoCo ' s ) ; TELCOM, 
telecommunications capabilities at home or 
from any phone booth; a TEXT processor, 
albeit limited; and two other applications 
whose primary uses were maintaining addresses 
and scheduling appointments and things-to-do. 
It also had parallel printer port, RS-232, a 
Bar Code reader, a terrific keyboard, and 
much more. But the best thing about this 
highly tauted Tandy toy, was that it fit into 
any standard briefcase and you could compute 
anyplace you happen to be. The price was: 
$999.95. 

Originally, the M-lOO was designed to 
store its data on tape cassette. You long 
time CoCo users know what that is like. So 
the very first obstacle to overcome was stor- 
age capacity and more speed. Early on, Tandy 
offered its Disk Video Interface, but it cost 
$800! Also, it was clumsy to hook up and un- 
hook the darn thing. Furthermore most people 
bought the M-lOO for its portability, and the 
DV/I seemed to run contrary to intent. Then a 
company in Dallas came up with a unique con- 
cept. They called the program DISK+. It 
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required a null modem cable and had 2 func- 
tions. First, it would allow you ^o hook up 
to your CoCo via the serial po-c, and store 
programs and files on your CoCo ' s drives. 
Also, it could unload or load them at 9600 
baud! Additionally, it had a file transfer 
program so that you could convert the files 
back and forth from Model 100 format or CoCo 
format. For example, if I were on the road, 
and picked up a nifty program off the CoCo 
SIG on CompuServe, I could down load it to my 
M-lOO and then upload it to the CoCo when I 
returned home. So this was my first use for 
interfacing the CoCo with my portable: stor- 
age space, and speed of file saving and 
loading . 

This interface ability became a real boon 
in the near future. I had moved from Seattle 
to my current residence in Port Orchard and 
had to commute back and forth on the ferry 
boat every day. Fortunately, I was able to 
use the commute time productively. I could 
type away on my portable and then transfer 
files to the CoCo when I arrived at work. I 
kept my time management and scheduling pro- 
gram on the model 100 so I always had the 
information at hand. The files could be 
stored on the CoCo at work and on my M-lOO's 
"Chipmunk" disk drive at home. I don't think 
I could count the number of documents 
polished up on Telewriter 64tm that had 
originated on my M-100. The Spreadsheet I 
used is called LUCIDtm. It is a very sophis- 
ticated program with capabilities I did not 
have on the CoCo. I could store spreadsheet 
files on the CoCo disk. Also, I could spool 
the formatted output to an ASCII RAM file and 
read it into Telewriter at work. These and 
other applications like them, made my com- 
muting days much more tolerable. 

THE PRESENT 

The "CoCo/Pico" romance w.as now in full 
bloom and has continued ever since. In my 
present job at Boeing Commercial Airplanes, I 
am not allowed to bring my laptop to work. 
Now I have a seperate workstation in my 
office at home and have it hooked up to a 
Disk Video Interface. (I got it cheap!) I've 
increased the RAM to 96K and have 2 drives. 
Following are some of the specific uses I now 
have for the Model 100 and CoCo working to- 
gether and some of the advantages. 

I.) From a telecommunications point of view, 



using the laptop for all these tasks has def- 
inite advantages. Whether I am at home or 
away, I can always check my electronic mail 
boxes, attend on-line conferences, download 
programs and files for either machine, and 
avoid the limitation of needing to be home at 
the CoCo. 

II.) One of the niftier little file manage- 
ment programs I use for a variety of uses on 
the CoCo is JULIE THE MOUSE. This freeform 
file manager has the ability to output JULIE 
file formats to an ASCII file that can be 
sent via modem. Anyone having the program can 
download the file. Another way the laptop 
assists in JULIE applications is that I do 
not have to be home at the CoCo to initiate a 
new file. I can type in my records on the 
M-lOO in JULIE format. Then when I return 
home, I can upload the file to the CoCo. 

III.) One of the most unfortunate missing ap- 
plications for the CoCo is that of an out- 
liner. If you have never heard of one or used 
one, you don't know what you're missing! I 
use a model 100 program called IDEA! by 
Traveling Software INC. It is a program I 
cannot live without. In any case, I spool the 
IDEA! file formatted to a RAM file and then 
upload it to the CoCo and BUSINESS WRITERtm 
for cleanup and final formatting. 

IV. ) I still use LUCID spreadsheet and move 
the files up to the CoCo when necessary. 

THE FUTURE 

Hopefully, the capabilities and uses for 
the CoCo / Model 100 interface will increase. 
I have a programmer friend in Seattle who has 
an excellent client mailing list program he 
wrote for his CoCo. He also has a Model 100 
so he wrote a model 100 version of his mail- 
ing program and is working now on a method to 
allow the files to be read by either machine. 
He has also developed a special null modem 
cable that "tricks" the CoCo into thinking 
that the Model 100 is a printer. This allows 
him to send data files to the Model 100 from 
CoCo BASIC without the use of a terminal 
program. 

And finally, the is another undeveloped 
use for this setup that already exists be- 
tween the Model 100 and the PC compatibles. 
This is the ability to have a "host program" 
that allows the laptop user to call up his 
desktop from a remote location and actually 
run PC programs. This would be an excellent 
project for a talented CoCo programmer!! If I 
could "run" CoCo programs from a remote lo- 
cation using my laptop, it would be a users 
dream come true! 

If you are a CoCo user who has a need for 
some of these applications and abilities, a 
Model 102 laptop might not be a bad invest- 
ment. You might want to do it just for the 
fun! If you're a wife who considers your- 
self a "CoCo Widow", consider yourself lucky! 
Think how it could be if the darn CoCo 



followed you no matter where you went!. Ask 
my wife, she used to go crazy because I'd 
pack up my Model 100, a 360K disk drive, and 
a thermal printer and take it everywhere we 
go! All of this stuff runs on batteries and 
fits in a briefcase. But you work it out - 
I'm not a marriage counselor. 

iPOKE 113,0: EXEC40999 



Finally 



An answer for America's dying teens! 

For your free copy of this dynamic and 

powerful book, call us today at 

1-800-VICTORY . 




Also; 

See and hear young people who have 

already found the answer at 

Freedom Village, USA in Lakemont, N.Y. 

Check your local Christian 

radio and television stations for the 

Victory Today program. 

For more Information write 

Freedom Village. USA Ukemo nt. NY 14857 



VIP Database 1.1 

9"ONE OF THE BEST" JUL '84 '^RAINBOW 

VIP Database has all the features of VIP Database III 
described elsewhere in this magazine except the 
screen widths are 51, 64 & 85. Screen colors are 
black, green and white, double clock speed and 
Spooler are not supported. Even so, VIP Database is 
the most complete database for the CoCo 1 & 2! 
Version 1.1 has FASTER and more RELIABLE dtek 
access and single spaced reports. OISK$4ft9S 



VIP Database owners: upgrade to VIP Didabase 1.1 
for $5 + $3 S/H. Send only original dsk and Ifttolal 



VIP Writer 1.1 

RATED "BEST" IN SEPT '88 "RAINBOVir 

VIP Writer has all the features of VIP WKler III 
described elsewhere in this magazine except ttie 
screen widths are 32, 51 , 64 & 85. Screen colors are 
black, green & white, double dock speed is not 
supported. Spooler and menus are unavailable 
because of memory limitatk>ns. Even so, VIP WHter 
is the BEST word processor for Ihe CoCo 1 & 2! 
Version 1.1 includes the configuration/ printer 
installation program and RGB Hard Disk support. 
Available thru Radio Shack Express Order «90-141. 
Includes VIP SpeHer 1 ,1 DISK $69.95 



VIP Writer owners: upgrade to VIP Writer 1.1 for $15 
^ $3 S/H. Send only ORIGINAL disk and $18 total. 
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Dear Editor: 



Since SD Enterprises has taken over the 
VIP line of Color Computer software we have 
uncovered a problem with the way some of the 
VIP programs work with slower disk drives. It 
seems that the VIP Software does not allow 
sufficient time for some disk drives to come 
up to speed before reading or writing data. 

This problem has been totally solved by 
restoring the delay built into RSDOS within 
the VIP Software. The VIP Writer III version 
2.0 and VIP Database HI do not have this 
problem. 

New versions of the original VIP Writer, 
Speller, Database and Disk-Zap for the CoCo 1 
and 2 with this enhancement are available for 
a small fee. These new versions also add 
additional features. Please see our ads for 
more details. 

Paul Anderson 
S D Enterprises 

Thanks Paul for this updated information. 
Our readers are urged to watch for an updated 
review of VIP Writer III Version 2.0 

Dear Mr. Paul: 

My compliments to you on the direction you 
are taking CoCo Clipboard! You're doing a 
splendid job. 

I was especially interested in Boisy 
Pitre's article "Modular Programming". 
Excellent! It should be emphasized that 
regardless of what language you're using for 
programming (and this includes data-bases and 
spreadsheets), modular programming makes life 
much easier on all concerned and reduces 
logical programming errors. 

One suggestion I'd like to make regarding 
line numbers and -nterpreted Basics such as 
RS Basic. A significant improvement in speed 
can be obtained if the program organization 
suggested is altered. Place initialization 
statements at the end of the program and 
frequently used subroutines at the beginning 
of the program in the order of frequency of 
use. Put the main module somewhere in the 
middle. Subroutines used infrequently may be 
placed between the main module and the 
initialization statements. The first line of 
the program would contain only pclear and 
pmode statements, as required, immediately 
followed on the same line by a goto (Init- 
ialization Module) at the tail of the 
program. If the modular concept is carried to 
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its limit, the main module will consist only 
of "gosub" statements. 

This speed advantage (or loss) is due to 
the nature of most interpreted basics. Every 
time a line number is called, the interpreter 
goes back to the first line number, jumps to 
that line number, calculates the "distance" 
to the next line number, etc. until it 
reaches the desired line number. Putting 
initialization routines and other seldom used 
routines at the beginning of the program only 
slows everything down. 

A tip regarding remarks. As urged by Mr. 
Pitre, use them liberally. Frankly, if 1 
didn't have remarks, I wouldn't know what I 
did five minutes ago. But remarks slow down a 
program (have to step through those line). A 
better practive is to save and print a copy 
of the program after debugging. The delete 
all the remarks and renumber the line numbers 
stepping the line numbers by 1. This reduces 
the size of the program drastically and fur- 
ther speeds execution. If you want to make 
changes, they are usually more easily made to 
the original program followed by the delete 
and renumber process. 

Just my two cents - hope it helps. Again, 
keep up the excellent work. 

Ed Gresick 
Delmar Co. 
Middleton, DE 

As many of you may remember it was Just 
one year ago that we ran an article called 
*'The Dream Machine'' which featured Ed's CoCo 
Computer system and how it was used to run 
his Radio Shack Franchise store. That issue 
is still available in reprint form. 

In addition Ed has become one of our 
biggest supporters and joined with Darlene 
and myself - and Jim DeStafeno at the Phila- 
delphia Area Computer Society CoCo meeting in 
September. Ed has many years of programming 
experience and if you're in the Middleton 
Delaware area stop by and say hi to Ed and 
watch his CoCo business system go! 



To: Mike Dooley: 

I have been reading your Ham radio column, 
and I hope we will get some new interest in 
Ham radio from the computer people reading 
the magazine. 

Anyhow perhaps you can mention a few 
things in your column: 

1 ) The ARRL has a program exchange ser- 
vice, for an SASE they will send you a 



listing. Readers should write to the ARRL , 
Dept. PX, 225 Main St., Newington, CT. 06111. 
Include the SASE and ask for a list of 
programs . 

2) For Packet Radio try "Auto-Term" 

3) Check out STV pictures, no interface 
receive only using Graphicom. 

There is also a book from Radio Shack 
entitled "Electronic Programs for Circuit 
Designs", I don't have the catalog number but 
it only costs $4.95 and is a great bargain. 

I keyed in the ARRL Dept. PX programs, 
found out 2 of them have errors in them, as 
well as the programs from the Radio Shack 
book. I got the CoCo for Ham radio purposes 
and enjoy using it in the shack with the 
radio and as a stand alone computer. 

73's 
Dave 

(From Mike Dooley) Thanks for the letter 
and all of the good information! -f/ii be 
checking out the ARRL ' s program exchange 
along with the other programs you mentioned, 
I got my CoCo for the same reason as you* I 
kept finding all of these neat interfaceless 
programs for the CoCo and had to try them! 
I'll be covering as many as possible in the 
upcoming months ( bi-months? ) along with 
listings to be typed in. Hang in there, Dave 
. , . Ham Radip is growing ! 

Dear Publisher: 

Enclosed please find a check for the back 
issues mentioned in your flyer. 

If the magazine is as good as you say it 
is you can expect to see a subscription or 
two from this part of the country. I took 
your letter to our local CoCo club meeting to 
see what interest there would be. Everyone 
was enthusiastic but skeptical. Sure hope 
this is the POT OF GOLD at the end of the 
RAINBOW. A lot of us are getting tired of the 
CoCo being thought of as a kid's toy! 

Thank you in advance for what we hope will 
be a shot in the arm for the CoCo Community 
in the Atlanta area. 

Yours 

Alan R. Dages 

Stone Mountain, GA 

Dear Alan: Thanks for the support from your 
part of the country. We're working hard to 
promote the CoCo as a serious computer and 
our growing subscription base of over 800 
PAID is the proof. We can always use more so 
please spread the word! 

Dear Ted and Darlene: 

Enclosed is a money order for another 
year of your much needed magazine. 

I recently bought Multi-Vue, and am STILL 
having trouble trying to revise the "boot- 
list" file, so that I may take advantage of 
my 720K drive. Bob van der Poel stated in his 
article "New Boots" (July/August '88) that it 
took him about an hour trying to make his 



custom "bootlist". That would be Wonderful if 
that's all it took. Being "not-so-affluent" 
with OS-9, I've been working on this problem 
for a good solid 96 hours total, and am still 
messing with it. He's right - much too much 
HAS been written on this subject. So much, in 
fact, that there is no ONE place a person can 
go to for in-depth instruction. 

Another thing that nobody seems to be 
willing to fully explain, is if I can use the 
720K drive (now drive 2) as the default 
drive . 

Anyway, keep those issues coming, and I'll 
continue pounding away, and maybe if I hit 
all the right keys in the correct order one 
day, all this will seem foolish to me! 



Thank You 
Joe Arntz 
Poughkeepsie , 



NY 



Well Joe, here's your letter and I hope 
our readers will respond quickly to your 
needs. A source you might want to check out 
is the OS-9 SIG on CompuServe. I've received 
a lot of help and information on CIS and 
perhaps we will get one of the OS9 experts to 
be our on line guests during our monthly 
conferences . 



Well I wish we had more space for letters 
this month. As usual we love to hear from 
you by phone, letter or on CIS. 




The VIP Integrated Library 1.1 combines ail six popular VIP programs - Writer 
1 .1 , Speller 1 .1 , Gale, Databasel .1 , Terminal and Disk-Zap 1 .1 - into one program 
on one disk. The program is called VIP Desktop. Rom the desktop you have 
instant access to word processing with a spelling checker always in attendance, 
data management with mailmerge, spreadsheet financial analysis, telecommuni- 
cations and disk maintenance. Just move the hand to the volume on the bookshelf 
and the application is there. 64K req'd. $149.95 + $4 S/H US, $5 Canada, 
$10 Foreign.VIP Library is available thru Radio Shack Express Order #90-213. 



VIP Integrated Library owners: upgrade to the VIP Integrated Library 
1.1 for $25 + $3 S/H. Send only ORIGINAL disk and $28 Total. 



SD ENTERPRISES 

(503) 663-2865 P. O. BOX 1233. Gresham, OR. 97030 

Non VIP Library orders add $3 for shipping in USA, Canada $4, 

Foreign $6. COD orders add an additional $2.25. Personal checks 

allow 3 weeks for delivery. All other orders shipped the same day, 
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VIP Database III 

'\..a remarkable job in creating a nicely updated version of a tried and true CoCo 
database. ...this program just roars! Database III. ..a high powered productivity 

worker in your home or ojfice." -CoCo Ciipboard Sept. 1988 



• Supports 40, 64 and 80 column hardware screen. 

• Separate text and highlight colors for easy data entry. 

• Built-in floating point MATH package. 

• IN-M EMORY sort of all records for maximum speed. 

VIP Database III features selectable screen 
displays of 40, 64 or 80 characters by 24 lines 
with choice of 64 foreground, background, hilite 
and cursor colors for EASY DATA ENTRY. It 
uses the CoCo 3's hardware screen and double 
clock speed to be the FASTEST database 
available! VIP Database III will handle as many 
records as will fit on your disks and is structured 
in a simple and easy to understand menu 
system with full prompting for easy operation. 
Your data is stored in records of your own 
design. All files are fully indexed for speed and 
efficiency. IN-MEMORY SORT of records is 
LIGHTNING FAST and provides for easy listing 
of names, figures, addresses, etc., in ascending 



• Built-in mailmerge prints form letters & mailing labels! 

• Print spooler lets you print while you enter more data. 

• Stores 558 records of 256 bytes on a 1 disk system. 

• Multi-criteria search with up to 16 relational keys. 

or descending alphabetical or numeric order. 
Records can be searched for specific entries 
using multiple search criteria. The built-in mail- 
merge lets you sort and print mailing lists, print 
form letters, address envelopes - the list is 
endless. The built-in MATH PACKAGE even 
performs arithmetic operations and updates 
other fields. VIP Database III also has a print 
spooler and report generator with unlimited print 
format capabilities including embeddable 
control codes for use with ALL printers. 

DISK $69.95 



VIP Database owners: Upgrade to the VIP Database III for 
$39.95 + $3 S/H. Send ORIGINAL disk and $42.95 total. 



VIP Integrated Library 

/Writer Database Enhanced 

The VIP Library /WDE combines all six popular 
VIP application programs - VIP Database III, VIP 
Writer III, VIP Speller 1.1, VIP Calc, VIP 
Terminal and VIP Disk-ZAP 1.1 - into one 
program on one disk! The program is called VIP 
Desktop. From the desktop you have instant 
access to word processing with a spelling 
checker always in attendance, data 
management with mail merge, spreadsheet 
financial analysis, tele-communications and 
disk maintenance. * 

DISK $169.95 

For VIP Lbrary shipping please add $4 USA. $5 Canada. $10 Foreign. 

I VIP Library owners: Upgrade to the VIP Library A/VDE for I 
I $89.90* -H $3 S/H. Send ORIGINAL disk and $92.90 total. I 

* Future VIP Library upgrades available at reduced cost. 
All products run under RSDOS and are not copy protected. 




Merry Christmas 



SID Enitieipiriisis 

C>f503) 663-2865 ^POB 1233 Greshanri. OR 97030 

Non VIP Library orders add $3 for shipping and handling in USA. Canada $4. Foreign $6. COD orders 
add an additional $2.25. Checks allow 3 weeks for delivery. All other orders are shipped the same day. 



VIP Writer III 2.0 

49 5 K Total Text Space * EASY 4 Color MENUS 




COMPARISON CHART | 




VIP Writer m 


Telewriter 128 


Word Power 3.2 


Screen Display 


32/40/64/80 


40/80 


80 


Spelling Checker 


VIP Speller 


NONE 


FREE WARE 


Dictionary Size 


50,000 Words 


NONE 


20,000 Words 


RGB HD Support 


100% 


N/A 


Nd 


Print Spooler 


YES 


NONE 


YES 


Total Space 128K 


106,000 


48.000 


72.000 


Total Space 5 12K 


495,000 


48,000 


450.000 


N/A - Information is Nol Available. Numbers ace rounded lo the r»earest thousand. 



MORE SCREEN DISPLAY OPTIONS 

VIP Writer 111 offers mure screen width options -all with 24 lines 
and actual lower case letters using the CoCo 3's hardware 
display, it runs at double clock speed and has 4-color menus 
making VIP Writer III FAST and EASY to usef You can choose 
foreground, background, hilite and cursor colors from up to 84 
hues. Color can be turned ON or OFF for the best possible 
display using a monochrome monitor or TV set. VIP Writer III has 
a built in on-line context sensitive help facility to display 
command usage in easy to read colored windows. 

CUSTOMIZER & PRINTER INSTALLER 

VIP Writer III comes with a configuration / printer installation 
program which lets you customize VIP Writer Mi to suit your own 
liking. You can set screen width and colors as well as margins 
and more. You can also install your own printer and set interface 
type (serial, parallel or J&M), baud rate, line feeds, etc. Once 
done, you never have to enter these parameters again! VIP 
Writer III will load n' go with your custom oonfiquration every time! 

ASCII TEXT FILE STORAGE 

VIP Writer III creates ASCII text files which are compatible with 
all other VIP Programs as well as other programs which use 
ASCII fifes. You can use VIP Writer III to even type BASIC 
programs! There is a 48K text buffer (438K in a 51 2K CoCo 3) and 
disk file linking allowing virtually unlimited text space. VIP Writer 
til works with up to 4 disk drives and lets you display directories 
and free space as well as rename or kill disk files, in addition VIP 
Writer 111 supports double sided drives using RGB-DOS in ROM 
and is 100% compatible with RGB Computer Systems HARD disk. 



"...High powered software for the CoCo3 ...Fast, 
easy to use. ..a true bargain for the serious CoCo user" 
-CoCo Clipboard MARCH 1988 



POWERFUL EDITING FEATURES 

VIP Writer III has a full featured screen editor which can be used 
to edit text with lines up to 240 characters long with or without 
automatic word wrap around. You can select type-over mode or 
insert mode. There is even an OOPS command to recall a 
cleared text buffer. Other editing features include: Type-ahead • 
typamatic key repeat and key beep for flawless text entry • end 
of line bell • full four way cursor control with scrolling • top of 
textfile • bottom of textf lie • page up • page down • top of screen ♦ 
bottom of screen • beginning of fine • end of line • left one word • 
right one word • DELETE character, to beginning or end of line, 
word to the left or right, or entire line • INSERT character or line * 
LOCATE and/or CHANGE or DELETE single or multiple 
occurrence using wildcards • BLOCK copy, move or delete with 
up to TEN simultaneous block manipulations • TAB key and 
programmable tab stops * word count • line restore • three 
PROGRAMMABLE FUNCTIONS to perform tasks such as auto 
column creation and multiple copy printing. 



AUTOMATIC TEXT FORMATTING 

VIP Writer III automatically formats your text for you or allows 
you to format your text in any way you wish. You can change the 
top, bottom, left or right margin and page length. You can set 
your text flush left, center or flush right. You can turn right hand 
justification on or off. You can have headers, footers, page 
numbers and TWO auxiliary lines which can appear on odd, even 
or all pages. You can also select the line on which they appear! 
You can even change the line spacing! Parameters can be 
altered ANYWHERE within your text! 



"In the beginning there was VIP Writer and users 
saw that it was good, But it's not the best anymore. 
There's a new word processor to claim the 
crown... VIP Writer III -Setting the Standard" 
RAINBOW Sept 1988 



PREVIEW PRINT FORMAT WINDOW 

VIP Writer 111 features an exclusive format window which allows 
you to preview your document BEFORE PRINTING IT! You are 
able to move up, down, left and right to see centered and justified 
text, margins, page breaks, broken paragraphs, orphan lines etc. 

PRINTING VERSATILITY 

VIP Writer III prints TWICE as fast as any other CoCo word 
processor! It supports most serial or parallel printers using J3tM 
JFD-CP or Rainbow interface and gives you the ability to select 
baud rates from 110 to 19.200. You can imbed printer control 
codes anywhere in your text file EVEN WITHIN JUSTIFIED TEXT! 
VIP Writer III also has TWENTY programmable printer macros 
which albw you to easily control all of your printers capabilities 
such as bokl, underline, italbs and superscript using simple key 
strokes. Other features include: multiple copy printing • single 
sheet pause • add line feeds • print pause to change print wheel. 

BUILT IN PRINT SPOOLING 

Save up to $150 on a print spooler because VIP Writer III has a 
built in print spooler with a 57,000 character buffer whrch allows 
you to print one document WHILE you are editing or proof readnf 
another. You dont have to wait until your printer is done before 
starting another iob! 

50,000 WORD SPELLING CHECKER 

VIP Writer 111 includes VIP Speller AT NO ADDITIONAL COST! 
VIP Speller checks text for misspelled words and has a 50,000 
word dictionary that can be added to or edited, 

QUALITY DOCUMENTATION 

VIP Writer III comes with a well writter^ 125 page manual which is 
Laser printed, not dot-matrix like the competition. It includes a 
tutorial, glossary of terms and examples for the beginner as well 
as a complete index! VIP Writer III is truly the BEST you can buy. 

Includes VIP Spellerl .1 . DISK $79.95 



VIP Writer owners: Upgrade to the VIP Writer III 2.0 for 
$49.95 + $3 S/H. Send ORIGINAL disk arvJ $52.95 total. 



SID lEHiriEiRiPEnsJES 

0(503^ 663-2865 l^POB 1233 Gresham. OR 97030 



H503) 



Non VIP Llxaiy orders add $3 for shfipino and hanJing in USA Caf\ada $4. Foreign S6 COO ordeis 
add an ad<ftionaJ $2 2S. Checks alow 3 weeks tor deSwry, AH other orders are shipped the same day, 
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Writer III or Library AW owners: Upgrade to the VIP Writer III 
2.0 for $10 + $3 S/H, Send ORIGINAL disk and $13 total. 



TelewfiWf m Is 4 Uikmitk ol Cognttec, WaiS Po»« 3 i» 4 »#d«mafk at Maocan Sch**«- 



^•***********#**#***********************************************^^ 
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KEN -TON ELECTRONICS PRESENTS 

"REAL" S.C.S.I. INTERFACE -AND- THE DUAL RS-232 PAK 




HARD DRIVE INTERFACE 
$89or$1l9(with RTC) 

Real Time Clock Ballcry-backcd 

L.R. Tech Conipalablc 

Owl Dos Compalahle 

R(;B Dos Compalahle 

H-Dos Compalahle 

OS-9 Compalahle 

m pin ROM Sockcl 



DUALCOMM BOARD 
$74(Smgle) $89(Dual) 

Replaces RS-232 PAK 

2 ^ 6551 AX'.I.A.'s 

2 Indcpcndenl RS-232 C hands 

Jumper selectable for up lo 4 

(FOUR) Channels (wilh 2tu1 hoard) 

Ultra low power draw 

28 pin ROM Sockcl 



Build your Hard Drive ihc RIGHT way wilh a REAL S.C.SJ. Interface. All our products arc 
MIL'Specification Quality P.C Boards and carry a full Q() day Warranty- Both ihe Dual Comm and the 
SCSI Interface work directly with a YC'ABLE or the Multi-Pak Interface and are Made In ihe U.S.A. 

CALL US FOR PRICES ON CUSTOM SYSTEMS, HARD DRIVES AND CABLES 

Terms: 

Check or M.O. accepted (US Funds only) 

Please add $4.00 for S&H 

Phone Orders are welcomed! 

CALL 1-716^837^9168 (24 hr. order line) 



KEN-TON 
ELECTRONICS 

187 GREEN ACRES RD. 
TONAWANDA, hV 14150 



♦^ 
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